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Diferențe esenţiale între limbajele C# şi C++ 


DIFERENȚE ESENŢIALE ÎNTRE LIMBAJELE C# ȘI C++ 


1. Tipuri referentiale şi tipuri valorice 
2. Vectori şi colecţii 

3. Proprietăți 

4. Delegări și evenimente 

5. Interfete 


1. Tipuri referentiale si tipuri valorice 


Acest capitol urmăreşte punctarea principalelor diferenţe între limbajele 
C# şi C++. Testarea celor discutate s-a făcut pe aplicaţii de tip Console 
Application, pentru a nu complica înțelegerea cu elemente noi de interfață 
grafică. 


; ei nu instantiaza 


Tipurile de date folosite în C# se împart în două categorii: 
; care sunt manipulate direct, prin numele lor si 
alocate dinamic şi care sunt manipulate prin referințe. 

În categoria tipurilor valorice intră tipurile de bază şi cele introduse prin 
struct $i enum. 

În categoria tipurilor referentiale intra tipurile introduse cu class, 
interface şi delegate. 
Programul de mai jos surprinde diferenţele dintre cele două categorii: 


class Classl 
{ . 
public int Val = 0; 
} 
struct Structl 
{ 


public int Val; 


lass Test 


static void Main) 


{ 


Diferente esenţiale între limbajele C# şi C++ 
e Diferențe esenţiale între limbajele Cr şi C++ 


|. Struct) ‘tvhj:,.tvb.val:= 0; 


Struct] tv2 = tvl; “tv2.Val = 123; 
Classi tri = new Classl(); 

Classl tr2 = tril; tr2.Val = 123; 
Console.WriteLine("Valoric: (0), {1}", 


, tvl.Val, tv2.Val) Fi 


Console.WriteLine("Referential: (0), (1)*, © f 
„tr1.Val, tr2.Val); ° 


Console.Read(); 
} 


Si structura (tv - tip valoric) şi clasa (tx - tip referential ) au câte un 
singur membru: val; pentru ambele categorii se face acelaşi lucru: se 
definesc câte două instante, a doua fiind initializata cu prima, după care a 
doua este modificată printr-o atribuire. 


Structl tvi; tv1l.Vval 
Structi tv2 = tvi; 


tr2.Val = 123; 


Class1 trl new Class1(); 
Classi tr2 tri; 


Fig. 1.1 Comportamentul tipurilor valorice si al tipurilor referenţiale 
Jeşirea afişată indică totuşi diferenţe majore: 
Valoric:. 0, 123 


Referential: 123, 123 
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confirmând că tipurile referentiale sunt manipulate prin referință. Cheia 
explicatiei stă în atribuire:. pentru tipurile referentiale, atribui e face 
între referinţe, 
tri, fără a avea de-a face cu copieri de obiecte. 


Tipurile valorice fiind manipulate direct, prin numele lor, atribuirea 
presupune copierea conținutului din membrul drept, peste cel stâng. 


Spre deosebire de C++ unde o referință trebuia obligatoriu încărcată 
la declarare, mai târziu nemaiputându-se modifica ( referind mereu acelaşi 
obiect ), căci operaţiile cu referinţe se exercitau de fapt asupra obiectelor 
referite, în C# referintele pot fi definite nule, pot fi încărcate cu obiecte 
generate cu new sau cu referinţe de obiecte deja existente. Aşadar, în C# 
conceptul de referință se apropie mai mult de conceptul de pointer, numai 
că se dereferă automat. aara U g 


- Tipurile referentiale pot fi instantiate numai cu new şi deci sunt stocate 
numai în heap (memorie permanentă) ; iar tipurile valorice se generează pe 
Stivă (stack) | E a i : 

Operatorul new se adaptează returnând instanțe pentru tipurile valorice 
şi referințe pentru tipurile referențiale:; - he a Sosa 

Tipurile valorice sunt "structuri" şi pot tine metode; chiar şi tipurile de 
bază au metode; spre exemplu tipul int (suplinit aici printr-o constantă) are 
o metodă de conversie în string, pentru afişare: i 

string txt = 110.Tostring(); 

Există tipul decimal, pe 16B, care asigură o precizie mărită (1 e-28, 7.9 
E+28), fiind folosit pentru calcule monetare;: constantele decimal se dau 
terminând numărul cu m sau M (de la money i. în at 


N 


unt considerate egale dac 
; acelaşi obiect, sau dacă ambele sunt nu11. $ 


Tesveeeseeecnnstrnsnnserseenttotvuesstnesantuneesstsstesapesascesssenssaueetevesscerenaveesteense, none one snancedensesssorareeeeensesneneeeeeanies 


ă ambele referă 


s 
H 
H 


d 


Şiruri de caractere 


C# dispune de tipul string; String este un alias pentru clasa 
System.String; ca tipologie se încadiează în tipuri referentiale, dar cu 
unele particularități. Clasa string’ este derivată direct din object şi este o 
clasă sealed, adică din ea nu se mai poate deriva altă clasă. Clasa String 
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este immutable; adică un obiect odată creat nu mai poate fi modificat; 
eventuale modificări conduc la obţinerea altui obiect, care va fi adresat 
folosind. aceeaşi referință; sirurile rămase nereferite sunt colectate de 
garbage collector în vederea dezalocării lor ulterioare. ; 


Clasa string dispune de metode precum Compare, Concat, Length, 
ToUpper, ToLower, Substring etc. : 


Exemple de lucru cu şiruri: 


string sl = "text"; 

string text = “linia 1 \r\n linia 2"; 
Console.WriteLine (text); 

string fisl = "c:\\stud\\CS\\siruri\\fisier.txt"; 


string fis2 = @"c:\stud\cS\siruri\fisier.txt"; 
// copie la indigo 


char c = s1(0]; 

sl += text; 

string x = "sir", y = "sir", Z; Z = X; 

if(x == y) Console. WriteLine ("Acelasi"); 

if(x == z) Console. WriteLine ("Acelasi"); : ! 


Pentru a evita apelul de constructor cu new, se pot face direct initializari 
pornind de la şir clasic de caractere : string s1 = "text"; initializarea 
este explicitată de compilator prin: 


string s = new string(new char[]{'t','e','x,'t'}); 


Secventele de escapé sunt recunoscute şi onorate la afișare (exemplu, 
\x - return Şi An - newline). Dacă se doreşte netratarea secventelor de 
escape, se prefixează constanta cu caracterul @. Pentru că şirul este tratat 
exact aşa cum l-am redactat, varianta se mai numește “copie la indigo”. 

Operatorul de indexare [ ] poate fi folosit la localizarea unui caracter din 
şir. Cocatenarea se poate face şi cu operatorul +=. l 
i Două şiruri sunt egale fie când referă acelaşi obiect, fie când au | 
: același conţinut, lucru care nu se întâmplă cu alte tipuri de obiecte. 


a senvorusuocoveesteestogconsantces ean AAA A EAEE N OEO E E NEEE EA EAE AS OOE A A E A AEE E T.. 


În afara tipurilor de bază, programatorii pot defini noi tipuri valorice 
prin enum şi struct, $i noi tipuri referentiale prin class, interface $i 
delegate. 
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3 Diferențe esenţiale între limbajele C# şi C++ 


public enum Color { Rosu, Albastru, Verde } 


public struct Point { public int x, y; } 


public interface IBaza { void F( );} 


public interface IDerivata: IBaza { void G(); } 


public class A 
{ 


protected virtual void H(). { Console.WriteLine("A.H");} 


public class B: A, IDerivata 


{ 
public void F() 


{ Console.WriteLine("B.F, implementare IDerivata.F"); } 
public void 6) | 
1 Console.WriteLine("B.G, implementare IDerivata.G"); } 
override protected void H() 
{ Console.WriteLine("B.H, override pe A.H"); } 
} 
public delegate void DelegatVid(); 


Trecerea din valoare în referință şi invers se face prin împachetare şi 
despachetare ( boxing si unboxing ): 


class Test 


{ 
static void Main() 
{ 
int i = 123; 
object o = i; // boxing 
int j = (int) o;. // unboxing 
} 
} 


Toate tipurile (inclusiv cele de bază) sunt derivate din object şi 
moştenesc o metodă comună, de conversie în string: 


Console.WriteLine(3.ToString()); 
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2 Vectori colecţii 


Vectorii se declară sub forma: avantaj: dimensiunea 
nefăcând parte din declaraţie nu trebuie dată drept constantă la compilare, ci 
se dă abia la execuţie, în funcție de necesități. Programatorii de C++ 
recunosc în această modalitate de gestiune a masivelor, manipularea prin 
pointeri ( în C#, referințe ) a masivelor alocate dinamic. 


using System; 
class Test 
{ 
static void Main(string[] args) 
{ 
int [,] mbl = new int[2,3]; //alocare completa 
mb1[{1,2]=10; 


{ {10,11}, (20,21), (30,31) }; 


int [][] msi = new int[3][]; 
// aloca doar referintele de linie 


ms1i[0]= new int[3]; // alocare linie 1 
msi[1]= new int[7]; // alocare linie 2 cu alta'âim 
ms1(2]= new int[2]; 


int [][] ms2 = new int[3][]; 

ms2[1]= new int[7]; < 
Console.Write("\n"+ms2[1][3]); 

ms2 = msi; // se copiaza referinte, nu elemente 
msi[1][3]=13; .Console.Write("\n"+ ms2[1][3]); 
Console. Read(); 

} 


Programul exemplifică elementele de bază in lucru cu masive 
bidimensionale în C#. mb1 este un iv Hidimensional clasic; dimensiunile 
lui se dau la alocarea cu new, sau sunt deduse din lista de initializatori, cum 
este cazul lui mb2. Se observă că indicii nu au paranteze de indexare 

“individuale (mb1[1,2] şi nu mb1(1)(2)). 
Există şi declar aia i cu aubla indexare, dar ea ospade masivelor 


alocare doar precizarea numărului de linii, nu şi dimensiunea lor, căci face 

. alocări doar pentru trei referințe de linii. Abia ulterior, când e nevoie, se fac 

alocări pentru fiecare linie în parte, acestea putând avea dimensiuni diferite, 
de unde şi numele acestui tip de masiv. 

La copierea unui- masiv se copiază doar referința, nu si conținutul 

propriu-zis al masivului; dovadă că la prima afişare se indică valoarea 0 cu 
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PASĂRE dee 


care a fost initializat implicit ms2 [1] [3], iar la a doua afişare valo 
atribuită de fapt lui ms1[1] [3]=13 !!. 


Vectorii de tipuri valorice ( tipuri fundan le, enum, struct ) tin 


adică numele vectorului este referință 
(fig. 1.2 ). A 


int [] vi; : 


vi = new int[4]; 


new int[4] 
{ 1,2,3,4}; 


Fig. 1 2. Utilizarea vectorilor de tipuri valorice 


Vectorii de obi umele vectorului este 
referință, la zone de memorie 
statică în care au fost alocate şi instantiate obiecte (fig. 1.3 ). 


Pers [] vp; 


new Pers[4]; 


vp = new Pers[4] 
{ pl,p2,p3,P4)}; 


Fig. 1 3. Utilizarea vectorilor de obiecte (tipuri referentiale) 
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public int Marca; 
public string Nume; : 
public Pers (int, m,string n){ Marca=m; Nume=n; } 


) 


class principal 


static void Main(stringl[] args) 
i Pers pl; pl = new Pers(1,"Unu"); 
Pers. [] vp; vp = new Pers[4]; 
vp[0l= new Pers (0, "Zero"); vp[1]=p1; 
Console.Write("(0) - (1) \n\n", 
vp[1].Marca, vp[1].Nume) ; 
vp[2]= new Pers(2,"Doi"); 
foreach ( Pers crt in vp) 
Console.Write("{0} - (1) \n", 
crt.Marca, crt.Nume); 
Console.Read(); 
N 
) 


În C#, declaraţia Pers pi;nu înseamnă ca în C++ şi generarea 
unei instanţe, ci declară o referință nulă, ce trebuie încărcată ulterior sau la 
definire cu adresa unei instante deja existente sau nou generată cu new : 


Pers pl, p2; pl = new Pers (1, "Unu"); p2 = pl; 


Similar, declarația vectorului de obiecte Pers [] vp; înseamnă 
declararea unei variabile de tip vector de obiecte şi nu va instantia nimic; 
variabila în sine se instanţiază cu vp = new Pers[3] ; moment cand i se 
precizează dimensiunea în funcţie de câte referinţe va stoca; după aceasta, 


elementele referință se încarcă cu adrese de obiecte existente sau create 


adhoc. | 
.. vp[0]= new Pers (0, “Zero"); vplll=pl; 


“int(}] vi = {1,2,3,4}; ee f 
este doar o prescurtare ce va fi explicitată de compilator prin 


int {J vi. = ? J int{4] {1,2,3,4}; 


Vectorii pot fi parcurşi clasic, folosind for şi adresare indexată, sau 


pot fi parcurşi cu foreach, ca şi colecțiile. 
foreach ( Pers crt in vp) 
Console.Write("(0)- (1) \n",crt.Marca, crt.Nume) ; 
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În nici una din extéfstifé următoare, ale programului de mai sus, nu 
se crează noi obiecte, ci doar referințe, una pentru tot vectorul de mai sus: 


Pers [] copie = vp; // o referinta la intreg masivul 
foreach ( Pers crt în copie) 
Console.Write("{0} - (1) \n"“,crt.Marca, crt.Nume); 


sau câte una pentru fiecare din obiectele pointate de vectorul initial: 


copie = new Perslvp.Length]; // referinte la fiecare obiect: 

for(int i=0; i<vp.Length; i++) cople[i]= vp[i]; 

foreach ( Pers crt in copie) f 
Console.Write("{0} - {1} \n",crt.Marca, crt.Nume); 


Programul de mai sus funcționează fara modificări, dacă punem struct 
în.loc de class, dar trebuie avut in vedere că în acest caz âtribuirile 


înseamnă copieri de instanţe, nu comutări de referință. 


Vectorii sunt derivați din clasa Array. şi moştenesc metode precum 
CopyTo, sau proprietăți, precum Length. 


Colecţii 


Un dezavantaj major al vectorilor este că au dimensiune fixă; chiar 
dacă se dă la momentul execuției şi nu la compilare, dimensiunea odată 


` declarată, rămâne fixă; dacă avem nevoie de un vector cu mai multe 


elemente, trebuie să alocăm un alt vector cu o dimensiune mai mare şi să 
copiem noi înşine, element cu element, vechiul vector la noua locaţie. 

Desi tin tot elemente de același fel i torii, colectiile 
se alocă element cu element, fiind r 

O altă deosebire esențială dintre colecții şi vectori este că elementele 
unui vector au tip, pe când elementele unei colecţii nu; ele sunt de tip 
generic object; cum orice tip (inclusiv cele fundamentale) sunt derivate 
din object şi se pot converti la tipul de bază, rezultă că o colecţie poate tine 
orice tip de date, cu condiția ca toate elementele să fie de acelaşi tip. 

Se rezolvă implicit în acest fel şi problema templatizării, în sensul că se 
poate defini şi lucra cu o colecţie de tip generic, precizarea tipului făcându- 
se la momentul folosirii datelor din colecţie. 


li 


Chiar aplicate pe tipurile fundamentale, colecţiile tin tot obiecte, nu 
valori ca vectorii; aşadar când țin tipuri valorice se aplică procedurile de 
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„Diferen e esențiale într 


rm dresarea indexată: 
lista[1iJ=lista[2]; 


vect[l]=vect[2]; 


Cele mai utilizate colecții sunt ArrayList (lista) , SortedList (map), 
Queue (coadă), Stack (stiva) şi necesită includerea namespace-ului adecvat: 


using System.Collections; 
ArrayList lista; Sortedrist slista;: 
Queue coada; Stack stiva; 


Cele mai ‘tapers metode detinute de o colecţie sunt add, Insert, 
Remove; dintre proprietati amintim Count. >- x 
Programul de mai jos exemplifică asemănările şi deosebirile dintre vectori şi 
colecţii. De remarcat cum o colecţie poate fi: populată pornind de Ja un 
vector folosind metoda AddRange(), sau element cu element folosind 
metoda add(). Preluarea din colecție presupune si un cast 
((Pers) (lista[1]) ) .Nume="Nou“; pe când din vector nu. i 


Şi. vectorii şi colecțiile: pot fi parcurse atât cu foreach, cât şi cu 
for, dimensiunea vectorului fiind dată de proprietatea Length, iara 
colecţiei de proprietatea. Count. © S 5 ny 


class PEAT 
{os . ey thie 24 
static void Main() 
on 2 i 
opta ArrayList lista; SortedList slista; 
; Queue coada; Stack sťiva;- . eii 
` Pers [3 act, = new Pers (3) a ti. a Be 
C : „(new Pers (0, "Zero"), new Pers(1,"Unu"), °° 5: 
i new Pers(2,"Doi")}; © - 

lista = new -ArrayList (); PU . 
' lista-AddRange(vect); ` 

// lista.Add(new Pers(0,"Zero")); 

// lista.Add(new Pers(1,"Unu") ) 

// lista. Add(new Pers(2,"Doi"))}; 


. dista{1]=lista(2]; vect[1]=vect[2]; 
((Pers) (lista[1])).Nume="Nou"; vect[1].Nume="Nou"; 
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foreach(Pers crt in lista) etd 
Console.Write("{0} - (1) \t", 
crt.Marca, crt.Nume); 
Console.Write("\n"); 
foreach(Pers crt in vect) 
Console.Write("{0} - {1} \t", 
crt.Marca, crt.Nume); 
Console.Read(); 


3. Proprietati 
Proprietăţile combină un câmp cu metodele lui de acces; se puteau 
scrie şi funcţii obişnuite de acces, dar proprietățile separă mai strict accesul 
în citire, de cel în scriere, simplificând adresarea câmpurilor private. 
Sintactic, o proprietate se comportă ca o variabilă, dar în spate ascunde 
apeluri de accesori get, set 
La folosire, proprietatea apare ca nume alternativ pentru un câmp; nu 
ocupă spațiu separat, în memorie. 
set primeşte implicit un argument value, care este cuvânt cheie şi 
conţine valoarea folosită pentru modificarea câmpului privat. 
O proprietate este totdeauna publică şi returnează valori, ca şi o metodă; 
ea permite accesul la un câmp şi chiar validări asupra datelor conţinute de 
câmp. 
O clasă poate:conține numai unul sau ambii accesori age un camp, 
asigurând. acces în read, write, sau read / write. Loo la dP 


Restrictii: 
e nu pot fi declarate proprietăți de tip void; E 
e . fiind o încrucişare între câmp şi metodele sale de acces, proprietățile 
nu au referință: ote nu se pot transmite cu ref şi out, ca pean in 
; . funcţii; rate a H i 
je mu Se supraîncarcă, oferită câte « o singură sitemative de acces pentru 
citire / scriere. 


Exercitiu 
Să se exemplifice folosirea proprietăţilor pentru o clasă Produs.. 


Rezolvare i 
File / New / Project şi se Mews cipal apiibaties Console Application 
Numele aplicatiei: My_App 
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Se introduce textul de mai jos. - 


using System; 
namespace proprietati 
1 


class Produs 


{ 
string den, um; 
float pret; 
int stoc; : 
public Produs() {stoc=0;} 
public int p_stoc 
{ è 
get { return stoc; } 
set { if(value >=0) stoc = value; } 
) 
}; 
class Test 
| 1 
static void Main(string[] args) 
{ i 
Produs pl= new Produs();. pl.p_stoc=100; 
Console.WriteLine("\n Stocul este "+pl.p_stoc); 
w Jo 
) 


Variabila stoc fiind implicit privată, necesită proprietăți de acces; la 
stabilirea valorii ei se va avea în vedere că poate conține doar valori 


nenegative. 


ee 
. In C#, instanţele. de clasă Sunt referințe şi trebuie ae la obiecte 
. generate cu new: Produs pl = new Produs); 


e listarea cu Console.WriteLine a variabilelor se poate face şi 
concatenând un string cu o variabilă, fiind forțată astfel conversia 


la string: 
Console.WriteLine("in" + x ); 


Proprietăți statice 


Proprietăţile pot fi statice, dacă ele sunt asociate unor câmpuri statice. 
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Exemplu 


In clasa Pers există un câmp privat static vmin, care stă la baza validării 
vârstei unei persoane, validare făcută de asemenea printr-o funcţie statică; 
vmin fiind static, are asociată tot o proprietatea statică, VMIN, la scriere. 


namespace prop 
{ 


class Pers 


{ 
private int varsta; 
static private int vmin; 


private static int valid(int v) E i 
i 


if ( v < vmin || v-> 100) | 
throw new ArgumentOutOfRangeException ("varsta"); 
return v; 


) 


public static int VMIN 
{ set { vmin = value; } } 
public Pers(int v ){ varsta = valid(v);} 
} : 


class Principal 
Ea, 
“static void Mein (erring args) 
{ 
Pers.VMIN = 16; 
Pers pl; _ -pl = new Pers(15); 
Console. Read(); 


După cum se observă, calificarea s se face pornind de la clasă, nu de la 
obiect : pera.VMIN = 16; initializarea s-a făcut în Main(), înainte de 
instantierea vreunei persoane. Dacă în apelul constructorului s-ar da o vârstă 
mai mare ca 16, s-ar lansa automat o excepție de tip 
OutoOfRangeException. 
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4, Delegări si evenimente 
Mecanismul delegării 


delegate este tipul asociat unui obiect care încapsulează o referință 
la o metodă şi suplineste conceptul de pointer de funcţie din C++ ; are forma 
generală: delegate tip_rezultat nume( lista_param ); 


delegate void PersDelegat (Produs p,double suma ); 


anunță existența unui delegat numit PersDelegat, ce va stoca referinţe de 
funcții ce primesc obiecte de tip Produs și o valoare de tip double. 


Instantiat, ocupă spaţiu în memorie, capabil să stocheze referința uneia 
sau mai multor funcţii, nu rămâne doar o descriere formală ( prototip ): 


PersDelegat Popescu = new PersDelegat 
(a.cumpara_en detail); 


Prin initializare, delegatul a fost încarcat cu o referință (de funcţie) şi 
permite ulterior apelul metodei prin referință. Ulterior, delegatului i se pot 
ataşa şi alte metode, sau 1 se pot detaşa unele din metodele deţinute. 


Metoda cu a cărei referință se încarcă delegatul poate fi statică (de 
clasă) sau nestatica (de instanță), conform Signaturii, caz în care în nume 
apare o clasă (Produs. cumpara, adică delegare de a cumpăra orice produs), 
respectiv un obiect (a.cumpara_en_detail, adică delegare de a cumpăra 
doar en detail şi doar produse de tip a). . 

Referinta poate fi modificată dinamic, delegatul permiţând apelul mai 
multor implementări ale unor metode care au acelaşi prototip. 

De remarcat că deşi în prototipul delegarii nu apare clasa care furnizeaza 
metoda, când se încarcă delegatul, adresa metodei trebuie calificată pornind 
de la obiect sau de la-clasă; în funcţie de tipul ei. Dacă funcţia care invocă 
metoda (ex. „Main ()) face parte tot din clasa care furnizează metoda, 
metoda nu necesită calificare: pornind de la clasă (sau obiect), deoarece 
ambele. funcţii fac parte din aceeaşi clasă ( sau acelaşi obiect, în cazul 
metodelor nestatice). 

La încărcare se declară şi un nume de instanță delegat Eosen 
moment în care metoda referită se dă ca parametru în constructor. Nu 
trebuie dat decât numele metodei, căci prototipul coincide cu cel al 
delegării, altfel ar fi semnalată eroare de sintaxă. 


ZA 
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Delegatul permite legarea întârziată, adică amânarea precizării functiei 
de apelat, până la momentul execuției, când după ce se va încărca referința 
cu adresa uneia sau mai multor metode, se pot invoca metodele referite prin 
delegat: 

Popescu (proâ1,1000.0); 


În plus, delegatul poate “călători” fiind transferat ca TE în / 
din ques 


Exercitiv E 

Să se definească ŞI să se utilizeze un “delegat care să permită 
gestionarea metodelor de vânzare şi cumpărare, en gros şi en detail, în 
cadrul unor activități comerciale desfăşurate de o firmă. 
using System; 
namespace delegari 


{ 
delegate, void PersDelegat (Produs p, double suma ); 
class Produs. > s ia? i 


dies, 
í string den, | um; : 

public double pret; m ia eg 

public int stoc; A p : 

public. Produs(){_ stoc= Q; pret=1.0;) „| ip Pan 
) 


class Activ_comerciale 


{ eras 
public void cumpara_ en lea AT (Produs p, double suma) 
. A j We e A 

p.stoct=(int) (suma / p.pret); 

Console.WriteLine("\nCumpara en detail de "+ suma+” lei”); 


} iJ j; A i sik ta je A 
public void cumpara_en_gros (Produs p,double sumă) 


T 
p.stoc+= (int) (suma / (p.pret*0.9) ); 
Console.WriteLine("\nCumpara en gros de "+ sùma+” lei”); 
} ' 4 of date DERN e i zi ai p DOA Petey o : ‘ 


public void vinde (Produs p,dcuble suma) aoi 
{ ‘ 
P. stoc-=(i ntj (suma i p.pret); 
Console. writeLine ("An Vinde in valoare de "+suma);: 


} i Š : 
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class Test 
{ | i 
static void Main(string[] args) 
{ 

Produs prodi= new Produs(); 

Activ_comerciale a=new Activ_comerciale(); 

PersDelegat Popescu= new PersDelegat 

: ' (a.cumpara_en_detail); 
Popescu (prod1,1000.0); i 
Console.WriteLine (“|n Stocul este "+proal.stoc+" buc"); 
Popescu = new PersDelegat (a.cumpara_ en_gros) ; 
Popescu (prod1,1000.0); 
Console.WriteLine("\n Stocul este "+prodl.stoc+ 
“ buc\n\n"); 


Dupa cum se observa, declararea unui delegat se poate face in afara 
oricărei clase, deoarece înseamnă declararea unui tip; similar am fi putut 
declara o structură sau o clasă. Instantierea delegatului se face însă doar în 
interiorul unei clase, deoarece în C# nu mai există variabile globale. 

Delegatul ar fi putut fi declarat ca făcând parte dintr-o clasă, introducând 
astfel un tip interior unei clase, similar declarării unei clase într-o altă clasă. 
Numele delegatului va conține atunci şi numele clasei. Spre exemplu, putem 
face declarația: 


class Produs 


C SE RE A : ht ‘ 
public delegate void PersDelProd(Produs p,double suma ); 


// 


iar în Main (), care face parte din altă clasă, instantierea acestui tip se va 


face sub forma: es. 
Produs.PersDelProd x = new Produs.PersDelProd 
(a. cumpara_en_detail) ; 


de unde se vede că tipul delegate se numeşte Produs .PersDelProd; 
aceasta deoarece în C# locul operatorului "::" este luat de operatorul '." 

În ambele situaţii, apelul delegatului s-a facut din interiorul clasei Test, 
astfel încât metoda folosită pentru initializarea lui a necesitat calificarea cu 
obiectul a de tip Produs, iar invocarea nu a mai necesitat un calificator în 
fata numelui Ionescu. Dacă îl apelam din afara clasei Test, trebuia dat 
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numele clasei Test, dacă delegatul era static, sau numele unui obiect de tip 
test, dacă delegatul era unul de instanță. 


Multicasting este situația când pe un delegat aplicăm operatori += şi -= 
pentru a adăuga şi alte delegări (metode), respectiv pentru a elimina 
delegări. 

Pentru ilustrarea facilitatii de multicasting în programul de mai sus 
declarăm un alt delegat şi-l mandatăm să opereze toate genurile de activități 
comerciale: 


PersDelegat Ionescu; . 
Ionescu’ = new PersDelegat (a. cumpara_en_gros); | 
Ionescu += new PersDelegat (a.cumpara_en_detail); 


Ionescu += new PersDelegat (a.vinde) ; 
Tonescu(prod1,1000.0); 


’ Console.WriteLine("\n Stocul este “+prodl.stoc+" buc"); 


Se observa un dezavantaj; la apelul Ionescu(prod1,1000.0); se 


execută tot setul de operații, dar pe aceleaşi date de intrare; ideal ar fi să 


controlăm fiecare apel individual de funcție din vectorul de funcţii, astfel 
încât să putem particulariza după «i» atât funcţia, cât şi datele, dintr-o 
matrice de observații. a | 


Evenimente 


o clasă eveniment sau . "publisher" este o clasă ce înglobează : 
a. o instanţă de delegate, căreia i se pune în față public event 
b. o funcţie gen "fire", care activează delegatul, adică apelează o lista 
de funcții 
Pentru test este nevoie: 
e să definim efectiv un delegate numit Şi Handler, referință către p 


funcție de tip voia, fără parametri: 
delegate void Handler (); 


e să declarăm o clasă "publisher" conținând evenimentul pe care îl va 
notifica public celor care: subscriu ( se anunță interesați de 
producerea lui) şi 0 funcție de activare a metodelor comunicate de 
aceştia: 


am | 


class cls 


public event Handler 1st_metode; 


fire( ); 
}; l _ 
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e. să definim mai multe clase "subscriber", conţinând o funcție cu care 
subscriu la eveniment (eventual şi una cu care se detaşează de la 
eveniment) şi o metodă de prototipul delegatului, care doresc să le 
fie lansată automat în execuţie, la producerea evenimentului: 


class x 

{ ; 
public void Subscribe) { >m 7); 
public void Unsubscribe() EEE ce POG 
void xH 4) {pti EP 

d; i 

class y 

Age 
public void Subscribe () (ps iy ae 
public void Unsubscribe () | die ae E 
void yH () eof Migs EL yee 

); 


Nu sunt restricții privind succesiunea derulării mecanismului de 
producere şi tratare diferențiată a unui eveniment; uzual acest mecanism se 
desfăşoară astfel: | 

1. clasă publisher anunță celor interesaţi, un serviciu de notificare a 

unui eveniment; 

2. mai multe clase subscribers se abonează la serviciul oferit, 

comunicând funcțiile de tratare specifice fiecăreia; 

-3. la producerea evenimentului, de obicei depinzând de condiţii 
exterioare claselor implicate, clasa publisher sesizează evenimentul, 
îl notifică abonaților activând lista de funcţii comunicate de aceştia. 


Pentru adaptare la context, de cele mai multe ori, instanța delegat nu 
se încarcă din timp, ci abia când clasa subscriber primeşte notificarea 
producerii evenimentului; astfel abonaţii îşi pot adapta în timp metodele de 
tratare a evenimentului, în funcție de context. 


Observaţii: 
| e  instanţiind clasă publisher, instantiem şi membrul delegat; 
e instantiind delegatul putem deja să începem stocarea de 
referinţe de metode delegat; 
e putem avea mai multe clase care subscriu la un eveniment; 
e putem avea mai multe instante ale aceleeaşi clase care subscriu 
la un eveniment; 
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e handlere-le trebuie să fie cât mai generale, de obicei sunt fără 
argumente de apel şi returnează void; 

e dacă tipul delegate are parametri de intrare, trebuie să îi și 
denumim, de la început; 

e evenimentul se apelează ca si delegatul, folosind ( ). 


Fără folosirea delegate,( pointer de funcţii) evenimentul ar fi fost 
“legat” indisolubil de o clasă si de numele unei metode, pe care trebuie să o 
lanseze în execuţie; cu delegate, mai multe clase pot subscrie la acelaşi 
eveniment şi pot folosi metode denumite diferit, pentru că apelul lor se va 
face prin pointer (referință). 


Dacă în locul mecanismului de delegare s-ar fi folosit interface 
pentru funcţiile de apelat, urmând ca fiecare clasă interesată să îşi definească 
concret metodele ei, atunci am fi avut alte dezavantaje: 

e metodele ar fi trebuit să fie totdeauna publice, adică expuse 

"tuturor celor din exterior; 

e n-am fi putut ataşa / detaşa metode, deoarece toate metodele unei 
interfeţe fac parte obligatoriu din interfață . l 


Exercitiu 


Pentru exemplificare, vom considera că receptia unui hotel deschide 
un serviciu automat, cel de “desteptare" la o oră exactă. Clasa "publisher" 
Serviciu, care modelează acest lucru, conţine o listă vidă ce va colecta 
ulterior referintele funcțiilor comunicate de cei care subscriu la acest 
serviciu, precum şi o funcţie gen "fire", prin care activează la diferite 
momente de timp, lista de funcţii. 

Prin constructor, clasa serviciu publică oferta sa potenţialilor 
interesaţi, adică două clase de data aceasta de tip "subscriber", Turist şi _ 
Software, cărora le trimite adresa sa. Dispunând de această adresă, cele 
două clase se pot "abona", comunicând funcţiile ce doresc a fi lansate in 
execuție la producerea evenimentului: turistul. este trezit fizic, iar software- 


ul este lansat în execuţie, pe bază de timp. 


Instanta delegate necesită în acest caz şi parametri: ora şi minutul 
momentului la care abonaţii doresc trezirea. 

În clasa Principal, sunt instantiati un turist tl si un program prog]; 
referintele lor, sub forma unui vector de obiecte generice ( a se observa aici 
utilitatea derivării implicite a oricărei clase din clasa object şi conversiile 


specifice) ajung la instanţa clasei publisher, prin constructorul acesteia. 
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Când deşteptarea apare ca serviciu, clasa ştie potenţialii interesaţi (nu ` 


dezvolt noi servicii până nu identific potenţialii beneficiari) şi îi anunţă, 
punându-și referința în "memoria" acestora. După caz, cei interesaţi subscriu 
sau nu la diverse momente de timp, sau în timp se detaşează de la 
eveniment. Indiferent de toate acestea, într-o buclă for se simulează 
scurgerea timpului; serviciul recepție urmăreşte ora exactă şi o notifică, dacă 
este momentul oportun, abonaților săi. 


using System; 

namespace test_evenim 

{ 
struct moment { public int o, m;) 
delegate void Trezeste(int h, int m); 
class Serviciu 


{ 
public event Trezeste lista; 
public void Ora_exacta (int o,int m) // fire) 
( : 
if (lista!=null) lista(o,m); 
) l 
public moment [] vect_mom; 
public Serviciu( object [] vo) 
{ 
vect_mom = new moment[10]; 
((Turist)vo[0]).s=this; // se anunta 
((Softwaré)vo[1]).s=this; // clientilor 
) 
3} 
class Software 
{ 
public Serviciu, s;_ 
public void Rulare(int h, intm) 
{ i i i - . 
if (h==s.vect:_mom[1].0 && m==s.vect_mom[1}.m) 
Console.WriteLine 
("in Progl running start at "+h+":"+m); 
) | 
public void Subscribe(int o, int`m) 
( : 
s.lista+= new Trezeste(this.Rulare); 
_s.vect_mom[1].0= o; s.vect_mom[1].m= m; 
} 
} 


28 


Diferente esenţiale între limba jele C# si C++ 


class Turist, 


{ 
public Serviciu s; 
public void Desteptare(int h, int m ) 
[ i Ve 
if (h==s.vect_mom[0].o && m==s.vect_mom[0].m) 
_Console.WriteLine A 
{"\n Turist tl trezit la ora "+h+":"+m); 
} | ' 8 i i IND gt Dh 
public void Subscribe (int o, int m) 
{ f 
s.lista += new Trezeste(this. hastepesbes: 
s.vect _mom[0}. o= 0; sS. ‘vect_mom[0]. m= m; 
nets | Š : 
} r 
public void Unsubscribe () di Sy i : 
{s.lista-= new Trezeste(this.Desteptare); } 
} 
class Principal 
{ 

static void Maint) 

(i e : ai 
Software voga new seu aa a Turist tis new: Turist (); 
object []vo=(tl,progi); // lumea obiectelor din jur 
Serviciu s=new'Serviciu(vo); AIER, 
t1.subscribe(11,30); prog1.Subscribe(0,30); Paes Saye 

//ti.Unsubscribe(); // are si detach({) 
for(int h=0; h<24; h++) S iaie 
for(int m=0; m<60; m+=30) 
{ // din 30 “în :30 min notifică ora exactas 
. s.Ora -exacta (h, m); ET bd! 
} A A E 
Console.Read(); © ` : 7 Pe pd etd 
} 
) | | 
) îm eta di 


Evident, acesta nu este singura modalitate de expunere a derulării 
mecanismului evenimentelor, dar este una dintre implementările cele mai 
uzuale. 7 


5 Interfete 


Interfetele permit separarea structurii unui obiect de modul în- care 
acesta este folosit; adică separă implementarea unui obiect de 
funcționalitatea lui, tot asa cum la utilizarea unui autoturism trebuie să 
cunoaştem funcţiile acestuia $i nu detaliile tehnice de realizare. 

Ne amintim că existau cel putin două motive care justificau moştenirea 
multiplă în C++ : | 
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e primul era legat de faptul că o clasă derivată era în acelaşi timp 
de două sau de mai multe tipuri de bază ( reamintim exemplul 
clasei Pegas, care era în acelaşi timp Pasare şi Cal ); 

e cel de-al doilea motiv era legat de generalitatea unor mosteniri de 
funcţii abstracte, cum ar fi serializarea obiectului, afişarea lui etc. 

C# exclude moştenirea multiplă ( derivarea din mai multe clase, simultan), 
dar permite totuşi derivarea dintr-o clasă si din mai multe interfeţe, adică 
păstrează posibilitatea abstractizării pure a unor metode ( cea de-a doua 
rațiune a moştenirii multiple), standardizând apelul acestora.şi obligând în 
acest fel clasele să dea implementări publice pentru ele. 

Interfetele sunt un fel de clase, care contin doar prototipuri de 

funcţii, numai că se declară cu interface în loc de class. Conventional, 
numele lor începe cu "I". 


Exercitiu 


Să se definească o interfață care să surprindă unitar principalele 
_ metode de deplasare, caracteristice deferitelor obiecte în mişcare. 


Rezolvare 


interface IMiscare 

{ 

void start(); _ void stop(); 

void inainte (int distanta, int viteza); 

void inapoi (int distanta,int viteza); 

boc] stanga (ini unghi); bool dreapta(int unghi); 


class vehicul: IMiscare 
{ f 5 es, ni 
„string tip; 
public void start () 
{ CORE OL Si ey SEE ESRAR vehicul"); } 


public vcid stop() 
{ Console.WriteLine("\nStop yehicul® } 


public void inainte(int distanta, int viteza) 
{ 
Console.WriteLine 
("\nVehicul {0} m inainte cu {1} km/h", 
distanta, viteza); 
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public void inapoi (int distanta, int viteza ) 
{ : 
Console.WriteLine 
("\nVehicul {0} m inapoi cu {1} km/h", 
distanta,viteza); 


) 


public bool stanga(int unghi) 
{ 
Console.WriteLine 
("\nVehicul stanga cu {0} grade",unghi); 
f return true; 
) : 


„public bool dreapta (int unghi) 


{ 
Console.WriteLine 
("\nVehicul dreapta cu {0} grade",unghi); 
. return trus; É 
JE ; 


} 


class Test | 
static void Main(string[] args) i 
{ 


vehicul v=new vehicul (); 
© v.start(); v. stanga (20); .. ES 
“v.inainte(10,100); - v. stop(); 
Console. Read(); 
ane 23 
} 
- O altă clasă, Pers, spre exemplu, ar putea fi de asemenea derivată din 
IMiscare, implementând de manieră proprie aceeaşi interfață de mişcare. 
La moştenirea dintr-o interfață, clasa trebuie să dea obligatoriu 
implementări pentru toate metodele interfeţei, cu respectarea strictă a 
numelui, tipului de retur şi parametrilor de. apel, inclusiv a eventualilor 


specificatori out, ref etc. . 


Interfetele: 


e nu pot fi instantiate, deoarece contin metode doar cu prototipul 
lor, nu și implementarile lor; 
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e nu conţin Câmpuri, nici chiar statice, ci doar metode şi eventual 
proprietăți (care sunt combinaţie între câmp şi metode de 
acces), indexări si evenimente (care sunt tot metode, dar mai 
speciale); 

e nu dispun de constructori si destructor, nefiind niciodată 
instantiate; 

e metodele nu poartă modificatori de acces, fiind totdeauna 
implicit publice; 

e nu pot îngloba struct, class sau enum, căci acestea s-ar asocia 
unor câmpuri, iar câmpurile nu sunt admise într-o interfață; 

e nu pot fi derivate dintr-o clasă sau structură (căci ar exista 
pericolul moştenirii unor date, lucru neadmis într-o interfață ), ci 
numai eventual dintr-o altă interfață. 


Dacă se doreşte ca o metodă moștenită dintr-o interfață să fie 
virtualizată la derivarea pe mai multe niveluri, prima implementare 
efectivă a acesteia într-o clasă, trebuie să menţioneze virtual. 

O interfață se aseamănă cu o clasă abstractă, în sensul că ambele nu pot 
fi instantiate, dar se deosebesc prin faptul că o clasă abstractă poate avea şi 


_ date membre, nu numai funcţii. 


Chiar şi abstractă fiind, când o clasă este derivată dintr-o interfață 
trebuie să dea implementări pentru toate metodele moştenite din interfaţă. 


Concluzionând, putem spune că utilitatea interfetelor constă în faptul că: 


e standardizează: funcţionalitatea - "unor"! obiecte înrudite, dând 
prototipuri pennu unele metode prin care se lucrează cu acestea; 


`e obliga toate clasele să definească í public ŞI in mod specific or, 
aceste metode; 


e permit o adresare unitară a acestor metode, folosind Ell la 
interfaţa de bază, din care a fost derivat obiectul. : 
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Diferente esenţiale între limbajele C# şi 


Limbaj mixt procedural / obiectual: 

- se pot defini variabile şi 
constante de tipuri fundamentale, 
masive şi obiecte (tipul struct si 
class); 
programul poate contine functii 
independente, clase si structuri. 

In functie de tipul de aplicatie, punctul de 
intrare este diferit: 

- main) — pentru aplicaţii în mod 
consolă; 

WinMain() — pentru aplicaţii în 
Windows în tehnologie SDK; 
MyApp x; - definirea unui obiect 
de clasă derivată din clasa CApp 
pentru aplicaţii - Windows 
folosind MFC. 


Se manipuleaza adrese, ca pointeri sau ca 
referinte. 


Nu există implementat tipul sir de 
Caractere ca tip fundamental; diverse 
biblioteci de clase implementează acest 
tip (ex. String în STL sau CString î in 
MFC). ` 

Metodele unei clase se pot defini in 
interiorul 'unei clase (funcţii inline), cât şi 
în exteriorul ei. 


Limbaj pur obiectual: 

- toate variabilele cat 
constantele sunt tratate ca 
obiecte; 
programul este format numai 
din clase şi structuri. 


Indiferent de tipologia aplicaţiei o 
clasa trebuie să definescă o metodă 
statică numită Main). 


Se utilizează referințe; în modul de 
lucru unsafe se pot utiliza şi 

Tipul șir de caractere este introdus 
prin clasa string. 


Metodele se. definesc doar în 
interiorul clasei. ' 


O clasă poate conţine doar variabile 
membru şi cod. 
Incapsularea datelor şi a codulul | se face 
doar în structuri şi clase. 


Se permite moştenirea multiplă. 


O clasă poate conţine doar variabile 
membru, proprietăți şi cod. 


„La. fel. şi în C#, numai că există o 


diversitate de clase: class, interface, 


abstract. 


Nu se permite moştenirea multiplă la 


„nivel de clasă concretă (class). Se pot 


moşteni O clasă şi mai multe interfate. 


Tab. 1.1 Sinteza principalelor deosebiri dintre limbajele C# şi C++ 
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Lira Ras A AREE 


IMPLEMENTAREA ÎN C# A STRUCTURILOR DE DATE 
DINAMICE 


1. Aspecte generale 

2. Implementarea structurilor de date dinamice liniare 

3. Implementarea. structurilor. de date dinamice 
arborescente 


1. Aspecte generale 


In C#, ca şi în alte implementări ale limbajului C (C++), sunt 
definite clase de tip colecție, pentru a facilita lucru cu structurile de date. 
dinamice cum ar fi: lista, stiva, coada etc. Aceste preocupări au fost 
concretizate prin existența unor clase specializate, ca de exemplu, în MFC: 
CArray — pentru lucru cu masive, CList — pentru lucru cu liste, stive, cozi şi 

CMap — pentru implementarea structurii de hash (tabele de dispersie); alteori 
aceste definiri au făcut obiectul unor biblioteci specializate, ca de exemplu 
STL (Standard Template Library). In toate implementările s-a urmărit in 
mod deosebit pee utatea unei cât, mai mari generalian (din punct de Sa 
construirea de algoritmi generici). 

In C++, generdlitatea este asigurată prin faptul că se spot defini 
şabloane de clase (clase template), iar flexibilitatea se asigură prin scrierea 
unor secvențe de cod, trimise ca parametri altor funcţii, prin intermediul 
pointerilor Ja funcții. i prize 

C# fiind un limbaj pur: ‘obiectual, orice obiect care este a tip 


fundamental sau de tip. utilizator (tip abstract de date) derivă din clasa... 


Object adică poate fi’ manipulat şi ca tip object. Prin manipularea 
variabilelor de tip object, în limbajul C# se asigură o maximă generalitate 
colecțiilor de date. Fiind- vorba de un limbaj pur obiectual; înseamnă că nu 
se pot utiliza funcții independente, de aceea inducerea anumitor secvenţe de 
cod se face prin intermediul interfetelor. 

< In C# următoarele clase de tip colecție implementează principalele 
structuri de date dinamice: arrayList — implementează structura de listă, 
Stack — implementează structura de stivă, Queue — implementează structura 
de coadă şi HashTable — implementează structura de hash; 

Acest capitol nu îşi propune să prezinte implementările tuturor 

structurilor de date dinamice şi nici să definească toate operațiile aferente 
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lor. Scopul lui este de a implementa structuri de date dinamice, prin prisma 
obiectelor de tip colecţie din Cf. 


2. Implementarea structurilor de date dinamice liniare 


Toate clasele vor fi definite in domeniul de nume 
structuri _de_date_dinamice. Clasa lista se va defini ca o colecție de 
obiecte noa. Un nod se va implementa prin intermediul clasei nod care va 


aparține domeniului de nume noduri, ce va fi inclus în domeniul de nume ` 
structuri_de_date_dinamice. 


Un nod contine: 


e ca date, informaţia utilă (inf) de tip object şi legătura (next) către 
nodul următor, de tip referință la nod; 


namespace struc turi_de_date_ dinamice 


{ 


namespace noduri 


{ i 
public class nod 
{ A 
object inf; 
public nod next; 
public nod(object k) { inf=k; next=null; ) 
public nod(object k, nod urm) {inf=k; next=urm; ) 
public object informatia 
{ : 
get { return inf; } 
set { inf=value; } 
} 
} 
//..- 
} 


e constructori, unul pentru a initializa informaţia utilă din parametrul de 
apel şi legătura cu nu11 şi altul care inițializează atât informaţia utilă, 


cât şi legătura preluată prin parametru de apel; 
e proprietatea informatia pentru a obține / modifica informația utilă. 


Structura de ap lista 


Lista se va implementa prin intermediul clasei lista care apartine direct 
domeniului de nume structuri_de_date_dinamice şi care are ca membri: 
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“e> capul listei (cap) ce este o referință către primul element al listei ŞI 
numărul de noduri din listă (nrn); i 


e constructorul care crează a lista vidă; 


e metodele: adaugare() — pentru a adăuga un element în listă şi 
Afisare() — pentru afişarea elementelor listei; 


. proprietatea NrNodur4 obține numărul de noduri din listă $i se poate 
folosi şi pentru test de listă vidă. i i 


namespace structuri_de_date dinamice 
; x 
namespace noduri 
{ 
N public class nod { // ... definita anterior } 
public class lista 
{ 
protected noduri.nod cap; 
protected uint nrn; 


public lista() { cap=null; nrn=0; } 


public void Adaugare (object k) 
{ 3 

if (cap==null) cap=new noduri.nod(k); 

else 

{ 
noduri.nod@ aux=cap; 
while (aux. next !=null) aux=aux. next; 
aux.next=new noduri. nod(k); 


NIN++; 


} 


public void Afisare() 
( . 
noduri.nod aux=cap; ` 
while (aux!=nul1) 


{ 
'Console.Write(" - {0} ",aux.informatia); 
aux=aux. next; i : 
} 
} 
public uint NrNoduri { get { return nrn: } 3} 
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+ "oe TE. de a ea ZI 
Utilizarea acestei clase se poate Su Mala prin secvența următoare: 


class Principala 


{ 


"static void Main(string[] args) 
he ee . 
structuri_de_date_dinamice.lista 1= 

i = new structuri_de_date_dinamice.lista(); 
„1.Adaugare (20); 1.Adaugare (90); l.Adaugare (45); 
1.Afisare (); 4 

) ; 

) 


Cei care au folosit obiecte de tip colecţie în C# au văzut că se foloseau 
metode standard pentru operaţiile: uzuale. Astfel, pentru adăugarea unui 
element în colecţie se utilizează metoda aaa(), pentru ştergere Remove () , 
pentru căutare: contains () etc. Alinierea la acest standard se face prin 
definirea clasei lista ca fiind derivată din interfaţa IList: 


public class, lista : IList {.... } 


Stergerea primei apariții a unui element din listă se efectuează de 
către metoda sterge care primeşte ca parametru informaţia utilă a nodului 
de şters şi returnează un boolean cu semnificația true, dacă s-a şters un nod 
şi false, altfel. Această metodă apelează metoda privată sterg care 
efectuează ştergerea propriu-zisă a nodului, în manieră recursivă. 


public class lista: 
ră be 


Lif eae = 
bool sterg(ref noduri.nod str, object 6) 

if(str == null) return false; 

else seceta meet Sula a en a 
if (str.informatia.Eguals (0)) 
i no , | 
2 nrn==;  ! str=str.next; © GC.Collect(); 

return true; 
dete ae e a = ; 
else return sterg(ref str.next,o);. -: 
) 


public bool Sterge (object o) 
{ return sterg (ref Gap djs } 
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S-a precizat că se şterge un nod dacă informaţia lui utilă coincide cu 
valoarea parametrului de apel. Informaţiile utile fiind de tip object trebuie 
definită egalitatea dintre două obiecte de tip object. Acest lucru se 
realizează prin supradefinirea metodei Equals (), care aparține clasei 
Object ce este clasă de bază pentru orice altă clasă din C# şi introduce tipul 
object. Pentru informaţii utile de tipuri fundamentale (int, string, 
uint, double etc) metoda Equals() este definită, astfel încât nu sunt 
necesare alte redefiniri. In cazul în care dorim ca informaţia utilă să fie de 
un tip introdus prin intermediul unei clase de utilizator, atunci această 
metodă trebuie supraîncărcată corespunzător. 


Ca exemplu, vom defini clasa persoana cu membrii: 

- numele (num) şi vârsta (v) persoanei; ; 

- constructorul care initializeaza datele din parametrii de apel; 

- supradefinirea metodei Tostring() pentru a converti 0 persoana la un 
şir de caractere, utilă la afişarea unui obiect persoana; 

- supradefinirea metodei Equals() pentru a testa dacă două persoane ` 
sunt egale; se consideră că două persoane sunt egale dacă au aceeaşi 
vârstă; a l l 

- proprietatea Nume pentru a accesa numele persoanei. * ` 


public class persoana 

{ 7 
string nume; 
int v; . i ; A : 
public persoana(string np, int t){ nume=np; vet; er Pe 


public override string ToString() : a in 
{ return " "+nume+” “+v.ToString(); ) 


public override bool Equals(object p) 
{ return v==((persoana)p).v; } 


public string Nume. { get { return nume; } } 


Considerând aceste aspecte, clasa lista este funcţională atât pentru 
informaţii utile de tipuri fundamentale, cât şi pentru tipuri abstracte de date, 
după cum se poate observa în secvențele următoare: 


structuri_de_date_dinamice.lista 1 

new structuri_de_date_dinamice.lista(); 
1.Adaugare (20); 1.Adaugare (90); 1.Adaugare(45); 
1.Afisare(); 
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if(l.sterge(90))} Console.WriteLine(" Nod sters!! "); 
else Console.WriteLine(" Nod inexistent!! "); 
1.Afisare (); 


structuri_de_ = ista lp i 
new structuri_de_date_đinamice.lista(); 


1p.Adaugare (new persoana ("Ionescu”, 33)); 
lp.Adaugare (new persoana("Gigi", 12)); 
lp.Afisare(); 


if (lp. Sterge (new persoana(" ",12))) 
Console.WriteLine(" Nod sters!! Ja 
else Console.WriteLine(" Nod inexistent!! "); 


lp.Afisare (); 


In C# elementele unei colecții pot fi accesate în vederea prelucrării 
lor folosind instrucțiunea foreach. Pentru colecția noastră, definită prin 
intermediul clasei lista, instrucțiunea foreach nu funcţionează. Acest 
lucru devine posibil făcând următoarele completări: 

e clasa lista va mosteni interfața IEnumerable; 
e cao consecință a punctului anterior este necesar să se definească 
metoda GetEnumerator(), în clasa lista, dupa cum urmează: 


public IEnumerator GetEnumerator () 
“( return nrn==0°? null : new ListEnum(cap); } 


ih cazul in care lista e vida, metoda returnează null, altfel metoda întoarce 
un obiect care implementează interfața IEnumerator pentru 0 lista. Obiectul 
este de clasă ListEnum şi referă elementele listei prin intermediul capului 


listei (cap), : i eae 
e se defineşte clasa ListEnum care implementează interfața 


IEnumerator în domeniul de : nume 
structuri_de_date_dinamice: 


class ListEnum : IEnumerator 
{ 


noduri.nod aux, init; 
bool vb; 


public ListEnum(noduri.nod ccp) 
{ aux=init=ccp; vb=true; } 


public object Current {get {return aux.informatia;} la 
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public bool MoveNext() ` 


{ 
if(aux==init && vb ) 
{ vb=false; return true; } 
if (aux.next!=null) 
{ aux=aux.next; return true; } 
else return false; 
} f 


public void Reset() { aux=init; vb=true; i } 


) 


Din codul sursă se observă următoarele: 
- constructorul initializeaza membrii de tip nod cu capul listei si variabila 
booleană vb cu true; 
- metoda Reset () repune referința auxiliară aux pe începutul listei şi vb 
pe true; . 
- proprietatea current furnizează in afară informaţia utilă a “nodului 
curent (cel referit prin aux); 
- metoda MoveNext () are ca scop referirea următorului nod valid al listei, 
"caz în care returnează true; dacă nu mai există noduri î în listă returnează 
false: 


Instrucţiunea foreach începe prin a apela metoda Reset (), după 
care apelează metoda MoveNext () cu scopul de a referi primul element al 
colecţiei, adică primul nod valid al listei; scopul variabilei vb este de a face 
distincţie între primul apel al metodei MoveNext() şi celelalte, care. vor 
avansa referința aux atâta timp cât mai există un nod valid în lista. Utilizarea 
instrucţiunii foreach împreună cu colecţia lista se poate face acum sub 
forma: 


try 
{ 


foreach (persoana pers in lp) 
Console. WriteLine (pers. Tostzing (1): 


catch 


Console.WriteLine("Lista vida!!!"); 


S-a inclus instrucțiunea foreach într-un bloc try cu scopul de a lansa o 
excepţie îi cazul în care lista este vidă. 
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Structura de tip stivă 


Clasa stiva este definită tot în domeniul de nume 
structuri _de_ date_dinamice -şi. este derivată din clasa lista şi 
operează cu disciplina LIFO (ultimul intrat, primul ieşit). 


public class stiva : lista 
{ r 


public void Push (object o) 
cc i 
noduri.nod temp = new noduri.nod(o,cap): 
nrn++; cap=temp;. i i 


) 


public object Pop() 


{ 
if (NrNoduri==0) i ao 
_ throw new Exception (* !! Stiva Vida !! "*);- 
else ` i 
; t S E 
object temp = cap.informatia; 
i , cap=cap.next; . nrn--; Gc.Collect(); 
return temp; , 
) oo ae ve : 
} 
) t 


- metoda Push() inserează un nod în capul listei (vârful stivei); informația 
utilă, de tip object este dată ca parametru în metodă; 

- metoda Pop() extrage elementul din vârful stivei şi returnează informația 
lui utilă. In caz că stiva este vidă se aruncă o PACED He cu mesajul "Stiva 
vida". 

Pentru a testa dacă stiva este vidă se foloseste i iara NxNoduri 
moştenită de la clasa lista. - 

O secvenţă de cod în care se aeai sa stiva ar putea arăta astfel: 


structuri_de_date_dinamice.stiva s = 
new structuri_de_date_dinamice.stiva(); 
s.Push(34); s.Push(56); s.Push(49); 


try { x=(int)s.Pop(); } 
catch(Exception er) 


Al 
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{ Console.Write(er.Message); break; - ); 
Console.Write(" "+ x.ToString()+" "); 


while (s.NrNoduri !=0) 
{ 
x=(int)s.Pop({); bate 
Console.Write(" "+x.ToString()+" "); 


) 


Structura de coadă se poate implementa tot printr-o clasă derivată 
din Clasa lista, numai că -disciplina de lucru este FIFO (primul intrat 
primul ieşit) şi se descriu metodele corespunzătoare. 


3. Implementarea structurilor de date dinamice arborescente 


„Ca şi în cazul listei, arborele poate fi descris tot ca `o colecţie de 
noduri. În cazul unui arbore binar, un nod conţine informaţia utilă şi are 
cel mult doi descendenţi. Se poate descrie clasa ce implementează nodul 
arborelui binar (noda) ca fiind derivată din clasa nod a listei şi având în plus 
încă o legătură (nextd), pe care o considerăm către subarborele drept. Şi 
această clasă se va defini tot în domeniul de nume noduri. 


namespace structuri de_date_ dinamice 


f 
namespace noduri .. oT ees & ee. Oe Ce 
{ Li Fa Dă E 7 | T vee - ir oe ` fi ` er eer | 
public class nod {°  //definita anterior ' ): 
public class noda: nod. ::;: v a at 
{: ere eran Lee E a ane 
public noda nextd; i : 
public noda(object k): base(k). { nextd=null; ) 
public bool este_frunza () pie aes Eu d ae 
( return next==null && nextd==null; y 
) Faz K E meat 5 pets P 2 
a 
// 2 5 
) 
Observaţii. 


- constructorul clasei noda initializeaza ‘rons utilă din parametrul de 
apel şi pune legăturile pe nu11; 
- metoda este. frunza () testează dacă nodul este sau nu frunză. 
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Un arbore binar de căutare este un arbore binar (fig. 2.1) în care 
se respectă următoarele reguli: 


Fig. 2.1 Arbore binar 
- fie arborele este vid; 
- fie cheia k din nodul rădacină este mai mare decât toate cheile din 
subarborele stâng (ss) şi mai mică decât toate cheile din subarborele 


drept A la rândul lor subarborii ss şi sd formează tot arbori binari de 
Căutare. - 


Clasa care implementează structura arbore binar de căutare (arbbin) 
aparține domeniului de nume structuri _âe_âate_ dinamice si conţine: 
e  cadate, rădacina arborelui (xaa) şi numărul de noduri (nrn); 
e constructorul care crează arborele vid; 
e proprietatea NrNoduri, care furnizează numărul de noduri ale unui 
arbore; se poate folosi şi în scopul de a testa dacă un arbore este sau 
nu vid; 
e metodele: 
l =  Adaugare() pentru a insera un nod în arbore; apelează 
metoda privată ins (), care efectuează inserarea propriu- 
zisă a nodului în arbore, în manieră recursivă; l 
= Afisare() pentru a afişa arborele; apelează metoda 
„privată afis(), care, afişează. propriu-zis. arborele în 
forma Răcăcină (Stînga, Dreapta), în manieră 
recursiva; 


si anon 


pubiin. class: arbbiri l ao. idee. Be eae OR 


noduri. noda ‘rad; 
uint nrn; 
noduri.noda Ins (nodurisnoda f; ie dul o; IComparer comp) 
te i ae ce 
„if (comp=: =nul1) comp= Comparer. Default; 
if (r==null) 
ie f 


nrnt+t; 


43 


Implementarea în Cf a structurilor de date dinamice 


object, mai precis prin apelul metodei Compare () care primește două 
obiecte de tip object şi returnează un întreg cu semnificația; 

a <Odacă primul obiect este mai mic; 

= = O dacă cele două obiecte sunt egale ; 

" ..>0 daca primul obiect este mai mare. 
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return new structuri_de_date_dinamice:noduri.noda(o); 
) 
else 

{ 
if (comp. Compare (0, r.informatia)<0) 

r.next=ins ( (noduri .noda)r.next,o, comp) ; 

else 

if (comp.Compare (o,r. informatia)>0) 


r.nextd=ins (r.nextd, o, comp); Dacă se lucrează cu obiecte de tip fundamental, atunci se foloseşte — 


return r; clasa Comparer care implementează interfața 1ICompare pentru aceste tipuri. 
) In această situație parametrul de apel de tip Icompare va fi null, iar 
i interfața se va extrage prin invocarea proprietății statice Default a clasei 
void afis (noduri .noda r) Comparer 
{ : 
if(r!=null) if(comp=snull) comp=Comparer.Default; 
{ . 
Console.Write("  "+r.informatia. Dope (ue (ae "); Următoarea secvență de cod prezintă modul în care se poate folosi clasa 
a PE eee ees arbbin pentru lucru cu-arbori binari de căutare, având informaţii utile de tip 
Console.Write("("); afis ( (noduri inoda)r. next); fundamental. 
* Console.Write(","); afis (r. nextd) ; 
Console.Write(")"); 
) structuri_de_date_dinamice.arbbin a 
} new structuri_de_date_dinamice.arbbin(); ~ 
else Console.Write("-"); a.Adaugare(15,null); a.Adaugare(20,null); 


a.Adaugare (3,null); a. Adaugare (18,nul1); 
a.Afisare(); 


} 


public. arbbin() { rad=null; nrn=0; } 
Daca se folosesc iipări abstracte de date, induse prin intermediul 


dlaselor de utilizator, atunci trebuie definită interfața IComparer în mod 
corespunzător. De exemplu, pentru clasa persoana, definită anterior, 
considerăm că operația de comparare se face la nivelul numelui persoanei; 
în acest caz, numele fiind de tip elementar; se poate: invoca metoda 
CompareTo() specifică acestui tip: 


-public void Adaugare (object o, IComparer comp) 
{ rad=ins(rad,o,comp); } 


„public void Afisare() { afis(rad);.) 


public uint NrNoduri . (get. : { ‘return nrn; } } 
public class Pers Comp : Icomparar 
Inserarea unui nod în arbore trebuie să respecte disciplina pe care o { sae ears 

impune un arbore binar de căutare, deci operaţia are la bază comparații între 

informațiile utile din nodurile arborelui şi valoarea de inserat. Informațiile 

utile sunt de tip object, deci comparatia nu se poate face direct, ci prin 
intermediul interfeţei rcomparer. 

Se observă la metodele Adăugare () şi ins () că ultimul parametru de 

apel este un obiect care implementează. interfața Icomparer. Prin 


intermediul acestui obiect se face comparatia între două variabile de tip 


public înt Compare (object x, object y) a ae : 


return ( (persoana) x) .Nume.CompareTo ( ( (persoana) y) .Nume) ; 


} 


Utilizarea arborelui binar cu informaţii utile de tip persoana având 
definită interfața IComparer prin Clasa Pers_Comp se face sub forma: 


persoana[] p= >- = 
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A, 
new persoana("Ionescu", 13), new persoana("Adam", 33), 
new persoana("Vasile", 38) 


ai 


structuri_de_ăate_dinamice.arbbin b = 
new structuri_de_date_dinamice.arbbin(); 


Pers Comp pc = new Pers_Comp({); 


b. eee pe); b.Adaugare(p[1],pc) 
b. Adaugare (p[2),pc]); 


b.Afisare(); 


O altă modalitate de definire a unei interfeţe pentru propria noastră 
clasă constă în a deriva clasa din interfața respectivă. Astfel, se defineşte 
Clasa persoana ca. fiind derivată din interfața: Icomparer şi se 
implementează obligatoriu metoda: ati 


public int Compare(object , object ) 
Clasa persoana se descrie acum astfel: 


public class persoana : IComparer 
{ : 
// datele, metodele si proprietatile sunt similare 
// celor din definirea anterioara a clasei persoana .. 


public int Compare (objéct x, object y 
{ i : 


„return. oaie cena: Nume. Goga PE ia SA Nume) ; 


A 


Folosirea obiectului de tip persoana pe post de informaţie utilă în arbore se 
poate face ca în secvenţa: 


persoana[] p= 


{ PA 
new persoana ("Ionescu", 13), 
new persoana ("Adam", 33), 
new persoana (“Vasile", 38) 
}; 


structuri_de_date_dinamice.arbbin b = 
new structuri_de_date_dinamice.arbbin(); 
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b.Adaugare (p[0],;pl0]); b.Adaugare(p[1];p[0]) 
b.Adaugare (p[2],p[0]); 


b.Afisare (); 


Concluzii | 

In C# lucru cu colecții, în această formă, a fost generalizat în sensul 
că s-a folosit pentru implementarea structurilor de date dinamice, 
gestionarea datelor din controalele bazate pe colecţii (ListBox,:ComboBox, 
ListView etc.) şi a înregistrărilor dintr-un set de date (Dataset). 
Cunoaşterea aspectelor necesare definirii obiectelor de tip colecție este utilă 
pentru programatorii de C#, deoarece ei pot să-şi dezvolte acum propriile 
biblioteci de clase sau chiar Biblioie si de controale, după modelul definit în 
mediul NET. 


Exercitiu 


Să se completeze clasa arbbin astfel încât instrucțiunea foreach să 
se aplice şi pe obiecte ale acestei clase şi să echivaleze cu parcurgerea în 
inordine (stânga, rădăcină, dreapta) a arborelui binar de căutare. 


d 
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INTRODUCERE ÎN WINDOWS FORMS- 


. Crearea unei aplicaţii Windows 

. Derivarea controalelor 

. Modificarea dinamică a proprietăţilor 
. Utilizarea indexărilor 4 


A U NO = 


1. Crearea unei aplicaţii Windows _ 


i aplicații Windows se poate face fie 
, folosind mediul Visual C# care scrie automat o mare parte 
din codul sursă, în funcţie de tipologia aplicaţiei alese. Indiferent de maniera 
prin care se ajunge la codul sursă, el rămâne elementul de bază, fiind 
suficient pentru a reconstitui oricând sub mediul integrat, ultima formă a 
aplicației. l : 


1.1 Crearea unei aplicații Windows prin scriere de cod sursă 


Pentru a înţelege mai bine ce instrucțiuni sunt scrise automat, când din 
mediul vizual dăm diverse comenzi, dragăm controale pe suprafața formei 
sau atașăm funcții de tratare a unor evenimente, vom încerca să facem noi 
înşine acest lucru, scriind minimul de cod sursă necesar. 


Co 


System.MarshalByRefobject | 


te System. ComponentModel . Component 


a System. Windows. Forms. Form j 


Fig. 3.1 Ierarhia de derivare a clasei Form 
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i Cheia înţelegerii aplicațiilor de tip Windows Forms o reprezinta clasa 
system.Windows.Forms Form, în structura de derivare specifică bibliotecii 
de clase din .NET, ea este derivată printre altele din 


_ System. ComponentModel . Component şi deci fiind o componentă poate 
-interacționa cu alte componente, în maniera controalelor; fiind. o clasă 


derivată şi din system.Windows.Forms.ContainerControl ea poate tine 
alte controale. l 

Din denumirile de mai sus, doar ultimul cuvânt este nume de clasă, 
celelalte sunt denumiri de namespace-uri, adică subdomeniul care introduce 
definirea clasei şi domeniile din care face el parte. Acest tip de calificare 
asigură recunoaşterea clasei chiar dacă nu anunțăm în preambulul 
programului, prin using, domeniile de nume utilizate. = 

Este suficient pentru a avea o fereastră Windows, să derivam propria 
noastră formă din System.Windows.Forms.Form Şi s-o - instantiem în 
momentul lansării în execuţie a aplicaţiei: 


using System; ` : 
using System.Windows. Forms; 


public class Forml: Form 


{ 
public Forml () 
{ 


// Size new System. Drawing.Size(500,300); 
// Text = "Forma simpla"; . 


} 
public static void Main () 


{ 
Application.Run(new Form1() ; 


ds alge a eas g a 


2P) 

Putem să nu punem nimic în constructor ( liniile sursă comentate ) și 
programul tot afişează forma, dar cu coordonate $i dimensiuni implicite. 
Compilarea şi linkeditarea unui astfel de program se poate face din linie de 
esc /target:winexe /r:System.d1l /x:System.Drawing.dil 

/x: System.Windows.Forms.dll Formal.cs 


sau direct din mediul integrat ; în acest scop este suficient ca într-o aplicație 
C# Windows Application să substituim codul din fisierul xxx. es cu codul 
de mai sus şi să cerem din meniu Debug / Start without debugging. 
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© Introducere în Windows Forms 


pe 


iad, d Ye Ea Be Sh Programul de mai sus foloseşte o legătură moştenită, in ~ 
Dacă redimensionăm forma în Designer, mediul adaugă imediat o eveniment WM_PAINT şi o funcţie de tratare onPaint(). Von: atita 
funcţie numită 3 care notează noile coordonate ale i 
formei; ~ tot mediul pune şi apelul funcției în constructorul formei, astfel 


încât forma să beneficieze la trasare de noile coordonate . 


a MT 


acum să adăugăm noi o legătură între un eveniment declanşat de coun - 
prin apăsarea mouse-ului pe suprafața formei (MouseDown } $10 PURSE ~> 
tratare a lui. Avem nevoie de două lucruri: i 

e să scriem o funcție de tratare a acestui eveniment: spre excm™ r 


Mousebown să se înregistreze noua poziţie a mouse-ului şi S+ aa 
rescrierea textului la noua poziţie, prin invalidarea dreptunghiulu: “=~ 
de fereastra pe ecran: 


Vom modifica programul de mai sus pentru a scrie ceva peste forma 
afişată. Pentru aceasta,.vom intercepta mesajul WM_PAINT, suprascriind 
funcţia OnPaint () . 


Ks A 
i Be 


using System; ai.” 


; protected void Forml_MouseDown Ai 
using System.Windows.Forms; -: 


(object sender, Mousebventare 


using System.Drawing; ©: pie și pna i 
s Ea Ei ; x = e.X; i y= eY; 
public class Forml: Form n T 
Ei d as i | ae 
PR a e să înregistrăm ( în funcția InitializeComponent (), sau Aa) i 
i Ls ie) la ni 1, 'lega intre evenimentul Mcuseo*= > 
Text = "Forma scrisa“; funcţie) la nivelul formei, legătura di 1 eat aaa Ari 
) Ee ina Ss - funcţia de tratare propusă de noi, ataşându-i delegatului M 
protected override void OnPaint (PaintEventArgs e) numele functiei noastre: 
e.Graphics.DrawString MouseDown += new MouseEventHandler (Form1_MouseDown) i 
(“Scriere pe forma", Font, Sak f : se ee for! : ae 
Rew ROUGE RMERICOLCE-BIAGK) e Ad 200), Programul complet va arăta acum astfel: 
public static void Main) -> e a) 
i i using System.Windows.Forms; A 
i ii ii oa PERDERE using System. Drawing; th te Meg i i pe 
) sia f - am ed rte e: ba . $ K l 
i public'class Forml: Form : 


{ 


OnPaint () este o funcție moştenită de formă si suprascrisă aici, care private void InitializeComponent (),,..... 


tratează mesajul WM_PAINT, transmis de sistem ori de câte ori o fereastră { a ae 

4 = 7 a s E E is o — Y} o 
trebuie retrasată, Forma fiind în fond tot o fereastră, va primi şi ea mesajul new MouseEventHandler (Form1_MouseDew=? : 
atunci când suprafaţa ei trebuie retrasată (spre exemplu, o altă fereastră a Cae i cec tal pi 


suprăpus o porţiune din formă sau s-a dat minimize / maximize). | ~ : 
~ O onpaint() primeşte ca parametru un obiect de tip PaintEventargs 
ce tine argumentele necesare retrasării ferestrei ; vom prelua din acest 


private: float: x,y; i 
private Brush stâBrush; 
public Forml() 


obiect, referința la contextul grafic al ferestrei, folosit pentru afişare sir de { Ee 
caractere. Loo A ea a G SB InitializeComponent (); E . 
‘Size = new System.Drawing.Size(300,200); 
| : : A EI Text = "Forma cu rescriere"; 
Font este o proprietate a formei ( forma -are un font implicit, care x=y= 10; 
poate fi modificat ulterior); pensula şi coordonatele unde se face scrierea se stâBrush = new SolidBrush(Color.Black); 
instantiaza direct, în apelul funcției. ) 
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protected void Forml. MouseDown i A ea 

(object sender, MouseEventArgs e) 

{ d 

x = e.X; y = e.Y; 
Invalidate(); l 

) 


_ protected override void OnPaint (PaintEventArgs e) 
{ 
e.Graphics. DrawString ("Scriere pe forma“, Font, 


new SolidBrush(Color.Black), x, Y); 
} 


public static void Main() 
{ 
Application.Run(new Forml ()); 


) 


După cum se observă, acum apăsarea cu mouse-ul declanşează şi 
retrasarea formei, prin invalidarea dreptunghiului ferestrei ce conţine forma; 
retrasarea propriu-zisă se face prin invocarea metodei onPaint() . 


Gama evenimentelor este foarte variată, cuprinzând de la evenimente 
produse de utilizator ( cum ar fi actionari de taste sau mouse, stoparea 
execuţiei etc.) până la evenimente ce nu depind de utilizator ( receptionarea 
unui mail, modificarea unui fişier, terminarea altui program, scurgerea unei 
cuante de timp etc). 


Sintetizând, putem concluziona că 
. face prin două modalităţi: 


1. atașarea unei metode la delegatul specific evenimentului: 


_MouseDown += ratia Sit a 
f new MouseEventHandler {(Forml_MouseDown) ; 


2. suprascrierea unei metode protected moştenită din clasa de 
bază: ăi 


protected override void OnMouseDown 
. ( System.Windows . Forms .MouseEventArgs e ) 


{ 


base.OnMouseDown(e ) ; 
// cod sursa propriu funcţiei 
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:. Folosind mecanismul bazat pe suprascrierea metodei moştenite, nu mai 
funcţionează mecanismul bazat pe handler, aceasta. deoarece metoda 
onMouseDown originală era cea care activa şi metodele din delegat. 

Pentru a funcționa ambele mecanisme de tratare evenimente, se 
recomandă ca la suprascrierea unei metode să apelăm mai întâi varianta din 
bază şi abia apoi să scriem codul specific: 


base.OnMouseDown(e ) ; 


lucru pe care ni-l sugerează de cele mai multe ori şi sistemul, punând 


‘automat în funcţie, apelul de mai sus. 


Aplicațiile de până acum nu conţineau alte controale pe forma. Când 
acestea sunt preluate vizual din trusă cu instrumente (ToolBox) lucrurile 
sunt simple; ca să le creem prin program însă, va trebui să scriem cod sursă 


pentru: | _ T 
e declararea în clasa Form a unei referințe, prin care să gestionăm 


- controlul respectiv: 


private System.Windows.Forms.Button btn1; 


e instantierea controlului, în constructorul formei şi stabilirea 
principalelor proprietăți dorite: 
btnl = new System. Windows .Forms. Button () ; ; 
btni.Location = new System.Drawing. Point(100, 200); 
btni.Text = "Creat soft"; 


e Adăugarea controlului la colecţia de controale a formei 


Controls.Add(btni); 


Controlul este acum vizibil la momentul execuţiei aplicației. Ataşarea unor 
metode de tratare evenimente se poate face după acelaşi model ca la formă: 


btni.Click += new System.EventHandler (btn1_Click) ; 


unde btni_click este numele unei funcții scrisă de programator pentru 
tratarea evenimentului de click pe buton. 


1.2 Crearea vizuală a unei aplicații Windows 


O parte a muncii de scriere tod sursă depusă până acum poate fi 
făcută automat de mediul de programare, dacă vom crea vizual aplicația. 
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Dacă programatorul alege corect tipologia aplicaţiei, Designer-ul desenează 
el forma, iar prin dragarea de către programator a unor controale din 
ToolBox, mediul declară obiectele corespunzătoare, le stabileşte 
proprietăţile şi le înregistrează la nivelul formei. : 


Sub biblioteca de clase MicroSoft Foundation Classes, vizualizările 
erau alese în funcţie de specificul aplicaţiei: l 
e Forms: formular — specializată în introducere date în machetă 
document 


e TreeView: arborescentă — pentru vizualizări structuri expandabile de . 


date 
e EditView: editare - specializată în lucru cu texte 


e View ~ vizualizare generică, pentru reprezentări grafice. 


Sub .NET se revine aşadar la aplicații cu vizualizare unica, de tip forms, 
peste care se pun controale de vizualizare specializate ( TreeView, 
ListView, DataGrid, TextBox, Panel etc.) 


isual J# Projects- tt i =i] Windows Control Library 
Visual C++ Projects. . 0.00. 0 SEN Sinart Device Application: 
Setup and Deployment Projects. ` “AN ASP.NET Web Application 
Other Projects..." z Sy #8, ASP.NET. Web Service a 
Visual tated e E À F ASP.NET Mobile, Web Application 
a Roe eee Web Control Library 
FA Console Application 


Fig. 3.2 Alegerea sabionului de aplicatie 
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System.Windows.Forms este namespace-ul ce conţine ‘definiții pentru 
toate clasele uzuale de tip control şi funcţiile necesare lucrului cu fi ormulare. 


Există şabloane tip pentru aplicaţii (fig. 3.3); pentru o. aplicaţie Visual 
C# sub Windows se alege din meniu: 
File / New / Project Type: Visual C# Projects 
Template: Windows Application > 
şi se dă un nume, împreună cu localizarea, pentru noua aplicație.. 


După alegerea şablonului de aplicaţie, mediul integrat crează scheletul 
aplicaţiei. Lucrul poate continua apoi tot în manieră vizuală, mediul 
disponibilizând o serie de instrumente de programare vizuală. 


4 


AplicatiaMea 


Fig. 3.3. Principalele ferestre utilizate în programarea vizuală 
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Ferestrele mai importante disponibilizate de către mediul Visual C# si 
accesibile din meniul View sunt: 

e Class View — care afişează structura pe clase a aplicaţiei şi 

“permite accesul rapid la o funcţie din cadrul aplicației; 

e ToolBox - trusa cu controalele disponibilizate de mediu sau 
definite de utilizator şi utilizabile în aplicații; 

* Designer — componenta ce afişează partea vizuală ( resursele 
grafice ale aplicaţiei) şi scrie cod sursă pe măsură ce dezvoltăm 
vizual aplicația. 

e Code Xxxxx.cs — fereastra ce conţine codul sursă al aplicaţiei, 
parțial compus de către designer pe măsura proiectării vizuale a 
aplicației, partial scris de programator. 


» Properties — conține proprietățile obiectului curent selectat în 


„ Designer sau din codul sursă. Are două secţiuni: Properties 
- adică proprietăţile propriu-zise, sortate pe categorii sau 


alfabetic şi Events - conţinând evenimentele recunoscute 
şi/sau tratate de un control. 


Proprietăţile mai importante ale obiectului Form sunt: 
e Name — numele dat controlului de tip form ; 

e Text —textul ce apare in bara de titlu a aplicaţiei; 
œ BackgroundImage — imaginea afişată pe fundal; 

+ BackColor — culoarea de fundal; 

* Font — fontul de scriere etc. 


Putem pune o proprietate ( de exemplu culoarea de fond) a unor 
controale selectând mai multe controale simultan; nu toate proprietățile pot 
fi setate însă în această manieră, deoarece ele trebuie să difere de la un 
control la altul (spre exemplu, Location — conţinând poziţia controlului în 
` cadrul ferestrei de vizualizare). 

* „Proprietatea Name permite atribuirea unor nume: sugestive 
controalelor, iar funcţiile de tratare a evenimentelor recunoscute de aceste 
controale, când sunt generate automat au în denumire şi acest nume ( de 
exemplu, btncalcul_Click, sau menSave_Click), mărind lizibilitatea 
programelor. 

Forma este denumită implicit Forma, iar funcţia Main lansează 
aplicaţia invocând constructorul formei, făcând astfel legătura între aplicație 
şi fereastra de rulare: 
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` Introducere în Windows FOrms  _ —_— —— ~ 


Application. Run (naw Forml ()); 


Dacă dorim să-i dăm un nume mai sugestiv, modificăm in Properties 
numele formei ( Name: Forma_mea), apoi cu Find / Replace facem 
substituirea Forml Cu Forma_mea si în codul sursă. Când facem substituiri, 
trebuie să avem grijă să fie expandată şi funcţia InitializeComponent (), 
pin a substitui eventualele apariții şi în aceasta zonă. 


În C#, în locul funcţiilor independente se folosesc funcții membre 
statice în clase; ele pot fi lansate în execuţie chiar înainte de a genera obiecte 
din clasa respectivă. Funcţia Main () este şi ea membră într-o clasă; în cazul 
aplicațiilor formular ea face parte din clasa Form1, 


Modificările făcute în Designer sunt operate automat în codul sursă; nu 


sunt indicate modificări manuale în zona de cod pesuonals de către 
Designer. 


i pe si i ăsta dest sunt . directive. exit zono ET 
i comprimării unei zone din textul sursă, în timpul editării. 2 ui 


eratasnentinsenestanren ustenesimein nh meen aut nove none osas rone man enent voiam desnvamereseransnavnys pennant 


Adăugarea unei funcții într-o class 


e meniu View / Class View 
e  selectăm clasa dorită 
MouseRight si alegem Add Method 
e completam caracteristicile dorite, apoi codul sursă al funcției. 


Adăugarea vizuală a unei funcţii de tratare a evenimentelor . 
e meniu View / Designer; 


e  selectăm controlul care proguee £ evenimentul; ‘poate fi chiar forma 
principala a aplicaţiei; - 


e MouseRight + Properties, sectiunea Events ( butonul : 
e  selectăm evenimentul dorit ALA facem double click sau Bone numele . 


ales pentru funcție; 
e suntem introdusi în editorul de text sursă, unde completă cu codul 


dorit, 
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e automat, mediul crează un delegat (referință de funcţie), îl încarcă cu 
referința funcției nou create şi îl adaugă pentru subscriere la 
evenimentul dorit: | 


this.button_Ad.Click += 
new System.EventHandler (this.Aduna) ; 


Dacă dorim să renunțăm la o funcție de tratare trebuie pus spațiu în 
Properties / Events pentru toate controalele care o invocă pe post de 
handler şi eventual ştergem şi fizic textul sursă al funcției, atenţie căci de 
multe ori textul sursă este şters automat ! 


Exercitiu 


„Să se proiecteze vizual şi să se scrie codul sursă necesar unei aplicaţii 
care adună două numere si afişează rezultatul. . = 


Rezolvare 


1. File / New / Project Type: VC# 
Template: Windows Application 
2. Se aduc din ToolBox trei controale de tip TextBox ce vor conţine 
numerele şi trei controale de tip Label care vor eticheta ( Properties / 
Text ) cu a, b şi suma, câmpurile anterioare. Se poate construi mai întâi 
un cuplu label + textBox, apoi selectăm cu shift + mouse cele două 
controale pe care apoi'le multiplicăm prin Copy / Paste (Ctrl + C şi 
Ctrl+V). Pentru a dimesiona pe verticală un textbox’ trebuie să-i 
declarăm proprietatea Multiline ca true. 
3. Se colorează (Properties / BackColor + Custom sau System) în verde 
textbox-urile a şi b, respectiv cu roşu câmpul suma. 
4. Se separă cu o linie (GroupBox din ToolBox, micşorat la maxim, cu 
„spațiu în. proprietatea Text) primele două textbox-uri . care sunt de 
introducere, de cel de-al treilea, care este destinat afişării. 
5. Se denumesc textbox-urile (Properties / Name) cu a, b si suma. 
6. Se aduc din ToolBox două controale de tip Button, ce vor fi denumite 
(Properties / Name) b_Total şi b_Iesire şi vor fi inscripționate 
(Properties / Text) Total, respectiv Iesire. mă 


7. Pe butonul Iesire se pune (Properties + Events / Click) o funcție de 
tratare eveniment Click, conținând un apel de terminare a aplicației: 
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private void b_Iesire_Click 

(object sender, System.EventArgs e ) 
{ 

Application. Exit(); 


) 


Se putea şi mai simplu, dând double click pe butonul Iesire; suntem 
astfel direct introdusi în codul sursă pentru a completa corpul funcţiei de 
„tratare b_Iesire_Cl ick(), deoarece evenimentul Click de mouse este 
evenimentul implicit, de tratat pentru un buton. PE 
Pe butonul Total se pune (Properties + Events / Click) o funcție de 
conversie a celor două numere din text în int şi de adunare a lor, 
respectiv conversia rezultatului în text şi vizualizarea lui ca proprietate 
Text a controlului suma. 


private void b_Total_ Click 
(object sender, System. EventArgs e) 
{ $ 
int ila = Convert .ToInt32 (a. Text) ; 
i_b = Convert.ToInt32 (b.Text) ; 
suma.Text =(i_a + i _b) „Tostring(); 


"Gestiunea unitară a controalelor unei forme 


Uneori este nevoie de gestiunea unitară şi folosirea în instrucțiuni 
repetitive, a controalelor; spre exemplu, tratarea similară a câmpurilor dintr- 
o factură, pentru a le initializa sau pentru a calcula valoarea totală a facturii, 
În acest caz, se recomandă gestiunea TextBox-urilor cu ajutorul 
masivelor de referinte. Pentru a ne mentine in spiritul limbajului C# si fara 
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a restrânge din generalitate, vom exemplifica acest luciu printr-un singur 
vector de referințe. 


1. Declararea vectorului de referințe la TextBox, în definiția clasei 
formular: 


public System.Windows.Forms.TextBox .[]vr; 

2. Initializarea in constructorul clasei formular, a elementelor vectorului 
de referințe, cu obiecte generate dinamic sau cu referințe ale unor 
obiecte care geja există: 


vr = new System. Windows . Forms . TextBox [10]; 
vr [0] =textBox1; vr [1] stextBox2; 
` // controale deja existente pe forma 


otita E 48) 
{ s S 
' yrli]=new TextBox (); 
// controale noi, create dinamic: 
vr[i].bocation = 
new System.Drawing.Point (16, 50+30*i); 
_vr[i].TabIndex = i; 
vr{i].Text = 10*i+" "; 
this.Controls.Add(this.vr[i]); 
} 


3. Manipularea obiectelor prin vectorul de referinţe, în funcţiile de tratare. 
Pentru testarea referirii corecte, la apăsarea unui buton Numerotare, 
fiecare TextBox își afişează ( ca proprietate Text ) propria poziție. 


private void Numerotare_Click(cbject sender, EventArgs e) 
for(int i=0;i<5;i++) this.vr[{i].Text=it+" "; 


) . 
Exercitiu 


Să se construiască macheta $i programul de completare a datelor 
într-un document, conținând mai multe linii şi coloane, câmpuri 


introductibile si câmpuri calculate, precum si părți tipizate ale--- 


documentului. Se va asigura şi serializarea documentului (doar datele 
primare, nu şi cele calculate), cu posibilitatea restaurării documentului ŞI 
completarea automată a câmpurilor calculabile. 
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Rezolvare 


Aplicația FACTURA exemplifică gestiunea prin matrice de referințe a 


> tuturor textBox-urilor dintr-un formular. 


e se pune TextBox [][] m; la nivel de formă şi se alocă astfel referința 
la matricea de referinţe; 

e în constructor se alocă vectorul de referințe, apoi fiecare element din 
vector se va încărca cu adresa câte unui textBox, dintre cele create 
vizual (atenţie la ordinea în care au fost create): 

m = new TextBox[3][]; 
m{O]= new TextBox[7] 
{ textBox1,textBox2,textBox3, textBox4, 
textBox5,textBox6,textBox7 }; 
m[{1]=new TextBox[7] 
{ textBox14, textBox12, textBox12, textBox11, 
textBox10,textBox9,textBox8 ); 
m[2J=new TextBox[7] 
{ textBox21,textBox20,textBox19,textBox18, 
textBox1l7,textBox1l6,textBoxl5 }; 


e Se poate face o funcție apelabilă din constructorul formei, pentru a testa 
legarea corectă a referintelor la câmpuri; ea afişează linia şi coloana 


fiecărui câmp: 


public void Umple_Forma () 


{ 
ine isj; 
for (i=0;1<3;i++) 
for (j=0;43<7; j++) 
` m[i] [j].Textsi.ToString()+j.ToString(); 
} 


Ea poate fi apoi refolosită la initializarea cu spaţii sau zero a formei, la 
începutul lucrului sau după o salvare pe disc a unei facturi şi pregătirea unei 
noi completări. 

În antetul programului este nevoie de două namespace-urile ce cuprind 
prototipurile claselor si metodelor necesare serializării. 


using System.I0; 
using System.Runtime.Serialization.Formatters. Binary; 


: introducere în Windows Forms 
aaam itroducere în Windows Forms 

Pentru a beneficia de serializare se defineşte o clasă ale cărei obiecte 

Sunt linii din factură ( doar câmpurile introduse, nu şi cele calculate); ea 


poartă atributul de “serializabila”: 


[Serializable] 
class LinFact 
{ 
public string den; 
public string cant; 
public string pret; 
public LinFact (string d,string c, string p), 
( den=d; cant=c; pret=p;) 


) 
private void Salvare Click(object sender, System.EventArgs e) 
{ 
ArrayList list = new ArrayList(); 
for(int i=0;i<m.Length; i++) 
{ 
LinFact lin = new LinFact 
( m{i]{1].Text, m{il[2]. Text ee Text ); 
list.Add(lin); 
} 
FileStream s = : 
new FileStream(*factura. dat", FileMode.Create); 
BinaryFormatter f = new i Ey BOS EA (pe 
f.Serialize(s, list); 
s.Close(); Ă 
// de adaugat o functie ClearFform()si apelul ei aici 
) 


private void Restaurare Click 
(object sender, System.EventArgs e) 
{ 
FileStream s; 
s = new FileStream("factura.dat", FileMode. Open) ; 
BinaryFormatter f = new BinaryFormatter(); 
=, ArrayList lista = (ArrayList)f. Deserialize(s); 
s.Close();int i=0; 


foreach ( LinFact lin in lista) 
{ 

m[i)(1].Yext=lin.den; m[i][2].Text= lin.cant; 
m(i)[3].Text=lin.pret; i++; 


) 


“Calcul Click ‘ 
( this.buttoni, new System.EventArgs() ); 
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Calculul se poate efectua simplu, cu o funcție de genul următor: ' 
private void Calcul _ Click (object sender, System.EventArgs e) 
{ . 


double p,c,total=0; 
for(int i1=0;i<3;i++) 
; m{i}][0].Text=(i+1).ToString(); 
c=Convert.ToDouble (m[i] [2] .Text); 
p=Convert’.ToDouble(m[i] [3].Text); 
m[ij[4].Text=(c*p).ToString(); 
m[ij](5].Text=(c*p*0.19).ToString(); 
m{iJ[6].Text=(c*p*1.19).ToString(); 
total+=c*p*1.19; 


) 
txtTotal .Text=total. ToString(); 


l Lăsăm ca exercițiu, modificarea socanta de mai sus ; pentru a 
răspunde unor cerințe precum, machetarea unui document cu număr 
variabil de linii, stabilit la fiecare rulare şi defilare în document folosind 
scrollbar. Se va desena un singur rând din factură, apoi celelalte rânduri vor 
fi create dinamic, în constructorul clasei Formi, de aceeaşi dimensiune cu 
celelalte şi plasate la poziții calculate în funcție de poziția textBox-urilor din 
primul rand şi dimensiunea acestora. O altă modalitate ar fi să creem 
macheta cu toate liniile şi să ascundem ( Properties / Visible = false ) 
pe cele care nu ne interesează. i 


: Cu mouse right pe ToolBox se poate alege opțiunea sort Items 
; Alphabetically, pentru a regăsi mai uşor un control, după nume. 
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C \Program Files\Microsoft Visual Studio .NET 2003 \Common7\ 
Graphics \bitmaps\OffCtulBr\Small\Color ; 
i conține bmp-uri standard, utile în aplicații ' i 


Prin proprietatea WindowState se stabileşte cum să apară forma la 
începutul rulării: Normal, Maximized Său Minimized. 


Controalele CheckBox şi RadioButton 


Controlul CheckBox permite selectarea uneia sau mai multor opțiuni 
dintr-un grup de opțiuni, în timp ce controlul RadioButton permite 
selectarea unei singure opţiuni dintr-un grup şi se foloseşte pentru opţiuni 
mutual exclusive. 

Prezentăm în continuare câteva din proprietățile şi evenumentele mai 


Di ibili ] importante ce se regăsesc la controalele CheckBox si RadioButton. 
isponibilitatea unui contro pentru utilizator de a interactiona cu Guaskad NT prin ile ao Pale duck Cheek Box est bit 
acesta, cand controlul este vizibil (visible este true) se stabileste prin ieee 
eas e ati ee Proprietatea Checkstate specifică starea controlului şi poate fi una 
din valorile enumerării CheckState: Checked, Unchecked, sau 
Goaitoalele care pot primi focus, pot fi incluse într-o secvenţă de tab; ; atai ata 
se pot numerota rapid cu View / TabOrder, dând click în succesiunea de ~ 


parcurgere dorită. Unele controale pot fi sărite din secvență dacă au Proprietatea Threestate - indicates dacă CheckBox-ul permite trei 
“proprietatea TabStop pe false. Dacă proprietatea Taborder este true, se 


Stări. Pe false, controlul poate fi adus în starea Indeterminate doar prin 
poate modifica succesiunea şi static, doar pentru un contr schimband „E cod sursă, nu şi prin interfaţa grafică a designer-ului. 
valoarea din proprietatea TabIndex ; 


Proprietatea Checked nu indict totdeauna c corect starea s controlau, 
i deoarece pentru un control cu trei stări, valoarea true este returnată atât 


„ Controalele, au poziții relative la zona client a formei, în wip ce 
7 poziția formei este relativă la coordonatele ecranului. 


îi uz ani 


F pentru Checked, cât şi pentru Indeterminate. În consecință, se 
Ataşarea prin program a unui icon si a unei imagini de fundal pentru | | recomandă preluarea stării curente din proprietatea Checkstata. 
formă se poate face în constructor sau la încărcarea formei: e a ei ee tt ii at ta mia 
private void Forml_Load(object sender, System.EventArgs e) j Proprietatea Text conține textul explicativ ce însoţeşte controlul de 
er | “tip bifă. 
System. Drawing. Icon IC =. new System. Drawing. Icon. . 
MG ne rebate Va a j Caseta bifei se plasează uzual în stânga textului explicativ ce o 
this.Icon = IC; . Bi > : d enas : aa 
Bitmap BG = ati Bitmap ("C:\\Programs\\poza. bmp") ; însoţeşte, dar pot fi alese prin setarea proprietății CheckAlign şi poziţiile 
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TopLeft, TopCenter, TopRight, MiddleRight, ~~ BottomRight, 
BottomCenter, respectiv BottomLeft, poziţii ce se găsesc ca enumerări în 
enum ContentAlignment: 


checkBox1.CheckAlign = ContentAl ignment .MiddleRight; 


RadioButton şi CheckBox dispun de proprietatea AutoCheck; pusă 
pe true asigură ca la click pe ele să-şi schimbe automat starea vizuală, stare 
memorată şi în proprietăţile Checked si Checkstate. 


Starea poate fi setată sau comutată şi soft prin atribuiri de genul: 


this .checkBox1 . Checked = true; 
checkBox1.Checked = !checkBox1.Checked; 


Pentru controalele RadioButton este importantă gruparea opţiunilor 
ce se exclud reciproc şi plasarea lor în containere diferite ( GroupBox sau 
Panel). | 

CheckedChanged — este evenimentul implicit al: controalelor 
CheckBox şi RadioButton şi se declanşează ori de câte ori starea 
controlului se schimbă. 


i. Introducere în Windows Forms 


Controlul Scroll Bar 


Este o bară verticală ( VSerollBar ) sau orizontală ( HScrollBar ), 
dotată cu săgeți şi cursor propriu pentru defilare. Ea asociază 
dimensiunea ei fizică cu un interval dat de valorile întregi, indicate prin 
proprietățile Minimum şi Maximum. Poziția curentă a cursorului ei se 
asociază dinamic cu valoarea proprietăţii value. Modificând fizic la 
rulare, poziţia cursorului se modifică automat Value; invers, modificarea 
prin program a valorii din value determină deplasarea fizică a cursorului 
pe poziția echivalentă din lungimea barei. 

Evenimentul implicit este scroll, emis la orice defilare fizică în 
cadrul bării, folosind săgețile sau cursorul. El poate fi captat şi folosit la 
obținerea unor valori, preluând echivalentul din proprietatea value. ' 


Exemplu - 


e Se aduc din ToolBox un control VScrollBar, un TextBox şi un 
Button; l 
e  Selectând controlul scrollBar, se pun în Properties, valorile 1 şi 
50 pentru Minimum Şi Maximum, respectiv 1 şi 2 pentru proprietățile 
smal 1Change şi LargeChange, care controlează fineţea deplasării. 
e cu DoubleClick pe scrollBari, se înregistrează automat funcţia de 
tratare a evenimentului de serol11, iar noi completăm doar conținutul 
„funcţiei, scriind: | 


textBoxl.Text = vScrollBari.Value.ToString(); 


Aceasta face ca la o deplasare a cursorului, în TextBox să apară 
valoarea corespunzătoare din intervalul [1,50]. 

e  Selectând şi dând DoubleClick pe buton se înregistrează automat 
evenimentul Click pe buton, iar noi completăm doar conţinutul 
funcţiei, scriind: n Ea 

vScrollBarl.Value = 50; 


pentru a testa şi operația inversă. 
La rulare observăm că la deplasarea cursorului în cadrul barei, 


TextBox-ul afişează numărul echivalent poziției, iar la apăsare pe buton, 
cursorul este dus la maxim, adică echivalentul valorii 50. 
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Componenta ToolTip 


Mecanismul de ToolTip permite afişarea unui text ajutător în legătură - 


cu un obiect de interfață, atunci când mouse-ul rămâne în aşteptare mai mult 
timp deasupra obiectului. Deşi facilitatea pare strâns legată de obiectul cu 
care se asociază, ea este furnizată de către un control specializat, disponibil 
atât soft, cât şi vizual, in ToolBox: ToolTip. 

Din punct de vedere al programării lucrurile sunt simple: se 
instanțiază un obiect al clasei ToolTip, iar metoda sa SetToolTip() 
permite asocierea textelor ajutătoare unor controale existente şi recunoscute 
la nivelul formei. 


Forml () 
{ 
IE een FT 


ToolTip t = new ToolTip(); 
t.SetToolTip(b, "Buton creat soft"); 
t.SetToolTip(statusBarl1, 


"Aplicatia asteapta selectie optiune meniu"); 
t.SetToolTip(toolBarl1, 


“Apasati butonul asociat actiunii dorite"); 
PR aa ae BT i 


Nici din punct de vedere vizual lucrurile nu sunt prea complicate. 
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‘ Unele controale ( TabPage, ToolBarButton, StatusBarPanel ) au 
nativ proprietatea ToolTipText, prin care se stabileşte textul de afişat ca 


tooltip. : 
Pentru celelalte controale, aducând din ToolBox o componentă 


ToolTip vom observa că imediat toate controalele de pe formă vor 
dobândi o proprietate nouă: Tooltip On NumeComponenta, editabilă vizual 
şi prin intermediul căreia programatorul indică textul ajutător asociat 
controlului respectiv. 

Acest lucru ne permite să deducem că putem folosi în paralel 
mecanismul soft şi cel vizual, sau să lucrăm cu mai multe componente 


ToolTip în acelaşi timp. 


Spre exemplu, putem stabili un text la nivel de toolbar şi un altul, mai 
detaliat, la nivel de buton din toolbar: 


this.toolBarl.ShowToolTips .= ‘true; 


iar în colecţia Buttons: a obiectului toolBar1 se alege un buton şi i se 
completează proprietatea ToolTipText Cu textul dorit. 


i 
| 
i 
i 
i 
{ 
i 
4 
| 
i 
| 
i 
i 
4 


2. Derivarea controalelor 
Discutam mai devreme despre posibilitatea supraîncărcării (override) 
unor ‘functii moştenite dintr-o clasă de bază. Am realizat deja acest lucru 
pentru funcția onPaint a clasei Form. Dacă privim mai atent, realizăm că nu 
putem face acelaşi lucru pentru oricare control deţinut de formă, pentru 
simplu motiv că nu putem supraîncărca funcții decât în clasele derivate de 
noi din clasele de bază ale .NET Framework. Toate controalele de pe formă 
sunt instantiate direct din clasele lor de bază, nu am definit noi clase 
derivate din acestea. ` 
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O primă necesitate de a deriva propriile noastre clase din clasele de 
bază rezidă aşadar în nevoia de a supraîncărca o funcţie ( eventual de tratare 
a unui eveniment) prin propriul nostru cod sursă. 

O'a doua rațiune pentru care derivăm propriile noastre clase din 
clasele de bază este legată de.nevoia de a induce comportamente particulare 
unor controale, în locul celor generale cu. care sunt ele înzestrate. Vom 
exemplifica acest lucru în exerciţiul următor. 


Exercitiu 


Să se deriveze din TextBox controlul TextBoxNumeric care nu 
acceptă în intrare decât cifre, celelalte caractere neglijandu-le. l 


Rezolvare 


Se descrie noua clasa după încheierea definiției clasei Form1, altfel 
Designerul n-ar mai şti care clasă asigură vizualizarea. În cadrul clasei se 
suprăîncarcă funcţia onKeyPress, care în mod uzual tratează evenimentul 
KeyPress asigurând înscrierea caracterelor introduse de: la tastatură în 
câmpul afişat de TextBox. 
public class TexBoxNumeric: TextBox 

protected override void onKeyPress (KeyPressEventArgs e) 


{ a mmm mmm m ea ae 
if(e@.KeyChar >='0! &&. e:KeyChar'<= '9' ) 
base.OnKeyPress (e); 
else ; E l 
e.Handled=true; 
) n. 


Pentru caracterele acceptate, se apelează forma originală (moştenită din 
bază), în timp ce pentru celelalte se “înghite” evenimentul anunțând că a 


fost, tratat-(e.Handled=true). Avem în acest fel şi un gen de validare a . 


a 


ceea ce introduce utilizatorul de la tastatură: >; îi 

z is 4 ee Be FASE is cat oe 
Pentru a testa comportamentul noii clase, într-o aplicaţie obişnuită se 
declară o referință la un obiect TexBoxNumeric! © =. - 


TexBoxNumeric txtBoxNuml; — 
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iar în constructorul formei se instantiaz& acest tip de obiect şi 1 se stabilesc 


proprietăţile de vizualizare, după care este adăugat la colecţia de controale a 
formei: 


public Forml () 


InitializeComponent (); 
txtBoxNuml= new TexBoxNumeric () ; | 
txtBoxNuml . Location = new Point(100, 200); 
this.Controls .Add(txtBoxNum1) ; a 
} 


Nu ne mai ramane decât să ne convingem că TextBox-ul nostru 
lucrează bine, punând pe un buton o conversie în întreg a textului reţinut de 
3 ~ . E) . A 
control şi un calcul elementar (dublarea numărului citit): 


private void ptnCaleClick (object sender, System. EventArgs e) 


i int x= Convert. ToInt32 (this. txtBoxNuml . Text) ; 


bis. txtBoxNuml. Text= .(2*x) .ToString() i 
) . 


3. Modificarea dinamică a proprietăților 


O „parte. din proprietățile obiectelor grafice „pot fi nu numai 
initializate static, prin Designer,. ci, si modificate dinamic, pe parcursul 
rulării. În Properties / Dynamic Properties putem vedea toate proprietatile 
ce pot fi modificate, folosind denumirea lor sau nume alternative. ; 

Pentru inceput vom exemplifica cele de mai sus, cu două funcții care 
tratează evenimentele de MouseEnter ŞI MouseLeave, schimband textul cu 
care este inscriptionat (caption) butonul b_Iesire dintr-o aplicație.. 


riv te y ia Tesire MouseEnterx (objèct sender, cei Uo no aS 
ee System.EventArgs e) 


{ b_Iesire.Text="Exit"; } 


-ivata void Iesire_MouseLeave (object sender, _ . 5 
ci dl să System.EventArgs e) 


{ b_Iesire.Text="Iesire"; } 


1 
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Vom vedea acum cum prin modificarea dinamică a unor proprietăţi 
(vizibilitate, stare activă etc.) putem reconfigura controalele de pe formă 
pentru a ghida utilizatorul în introducerea datelor sau pentru a disponibiliza 
temporâr noi facilități ale aplicaţiei în regim de lucru “administrator”. 


Exercitiu 


Să se proiecteze o machetă pentru o aplicație de atribuire a unor 
mărci persoanelor dintr-o firmă. Se vor folosi controale de tip comboBox, 
ListBox din care se preiau marca și numele unor persoane si ListView, în 
care se vor vizualiza perechile marca-nume, deja formate. 


Rezolvare! 


Toate cele trei controale au un element comun şi anume faptul că tin mai 
multe item-uri într-o colecție. 


1. Într-o aplicaţie formular se adaugă din ToolBox controalele ComboBox , 
ListBox şi ListView si se denumesc (Properties / Name) prin 
cb_marca, 1b_pers, listVievwl. 

2. Se populează initial, pentru exemplificare, cb_marca cu câteva mărci ( 
selectând controlul + Properties / Items şi se adaugă în colecție mărcile 
dorite, terminate fiecare cu Enter ). 

3. Se populează iniţial 1b_pers cu câteva persoane, procedând ca mai sus. 

4. În InitializeComponent () se inhibă initial posibilitatea selectării unor 
nume de persoane înainte de extragerea unei mărci din combo. 


.. this:lb_pers. Enabled = false; 
5. Se configurează soft, în constructorul ` formei, vizualizarea de tip 
ListView cu două coloane, specificând antetul afişat, dimensiunea şi 
tipul de aliniere dorit: vy 


listViewl1.Columns.Add 
("Marca“,80,HorizontalAlignment.Center) ; 
listViewl .Columns .Add : sia 
("Numele si prenumele",200,HorizontalAlignment:Left); 


6. Aducem din ToolBox un buton Adaug, lângă cb_marca pentru a permite 
şi adăugarea de noi mărci, în afara celor introduse inițial. 


72, 


Introducere în Windows Forms 


7, Pe evenimentul click al acestuia punem cod sursă de adăugare în combo 
a mărcii înscrisă în zona de editare: 


private void Adaug_Click 
(object sender, System.EventArgs e) 


{ 


cb_marca.Items.Add(cb_marca. Text) ; 


) 


8. Se trage din ToolBox un mainMenu şi i se pune opțiunea Men_AdBut 
care ascunde / repune butonul de adăugare, dacă dorim să inhibăm / 
activăm posibilitatea de adăugare mărci. Optiunii din meniu 1 se tratează 
evenimentul click prin funcţia: 


1 


rivate void Men_AdBut_Click 
: (ohject sender, System.EventArgs e) 


{ 
if (Adaug. Visible==false) Adaug.Show(); 
i Adaug.Hide(); 


eise 


) 


9. La selectarea unei mărci din combo, se inhibă controlul cb_marca şi se 
reactivează lista de persoane 1b_pers, pentru a putea completa o 
pereche marcă-nume: 


private void marca_SelectionChangeCommitted 
(object sender, System.EventArgs e): 


{ 
this.1b_pers.Enablea=true; 


this.cb_marca.Enabled=false; 
} 


10. După selectarea şi a unei persoane, perechea constituită este pusă în lista 
de vizualizare folosind o structură. de tip ListViewItem, dupa care se 
inversează stările celor două controale, pentru a permite reluarea 
procesului de atribuire mărci: 


private void pers_SelectedIndexChanged 
(object sender, System.EventArgs e) 


_{ _ 


ListViewltem itm = 
new ListViewltem(cb_marca.Text) ; 

itm,Ssubltems.Adă (1lb_pers.Text) ; 

1istViewi.Items.Add (itm) ; 
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this. 1b_pers.Enablea=false; 
this.cb_marca.Enabled=true; 


Adam Dan 
+ Baciu Carmen” 


Să se dezvolte exemplul de mai sus cu facilitatea de adăugare de noi 
persoane în ListBox, precum şi Cu tratarea opțiunilor de salvare / restaurare 
în/din fişier a perechilor marcă — nume deja formate. 


4. Utilizarea indexărilor 


Indexările sunt un gen de supraîncărcări ale operatorului de 
indexare [] , dar nu apar ca metode, adică nu au operatorul ( ), ca orice 
funcţie, ci dau parametru direct între parantezele de indexare []; 


Indexările permit adresare vectorială pe tipuri care nu sunt vectori ( ex. 
bitul al 5-lea din reprezentarea binară a unui întreg ); din această cauză, un 
tip inzestrat, cu o indexare se mai numeşte şi "smart array"; 


Posedând accesori get şi set, indexările apar ca dezvoltări ale 
conceptului de vector, tot aşa cum proprietățile sunt dezvoltări ale ideii de 
câmp. MES 8 i 


Exercitiu 

Să se definească tipul biti prin înzestrarea tipului int cu capacitatea 
de autoindexare, pentru individualizarea unui bit după poziția sa. Să se 
folosească acest tip pentru a memora prezența sau absenţa de la serviciu a 
unei persoane, în cele max. 31 de zile ale unei luni. 
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Rezolvare 


re 


Într-o aplicație C# de tip Console Application se introduce textul sursă: 


namespace indexari 


{ 
struct Biti 
{ 
private int b; 
public Biti(int val) { b = val;} 
public bool this[int idx] i 
{ 
get { return (b & (1<<idx))!=0; } 
set 
{ 
if(value) b |= (1<<idx); 
else b &= ~(1<<idx); 
} i 
) 
) 


class Test 


{ 
static void Main(string[] args) 
{ 
Biti prezenta = new Biti(0); 
prezenta[5]=txue; prezenta[27]=false; 
prezenta[7]=prezenta[5]; | . 
Console.Write("Prezenta ziua'de 7: " +prezenta[7] ); 
} . 
2 
} 


Se observă că întregul b conținut în structura Biti este prelucrat 
folosind operatori pe biți, pentru a seta, respectiv a extrage, doar bitul 
indicat prin index. ` l l ; 

Indexarea public bool this[int idx] prin accesorii ei, get şi set, 
simplifică adresarea fiecărui bit, ca şi cum prezenta ar fi un vector de biţi. 

O indexare poate fi doar de tip read, doar de tip write, sau de tip read / 
write, în funcţie de ce accesori furnizează ( doar get, doar set, sau ambii ). 
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Aşa cum operator[] nu se supraincarca decât prin funcție membră. - 


nestatică, o indexare nu poate fi definită Static; de altfel ŞI cuvântul cheie 
this sugerează legarea indexării de un obiect curent, nu de clasă în genere. 


Un dezavantaj al soluţiei propuse este că numărul maxim de biti este 
32, adică dimensiunea unui int; pentru un număr mai mare, trebuie alocati 
mai mulți întregi şi anume n / 32, unde n este numărul de biti necesari. Iată 
cum ar arăta în acest caz clasa care tine biții şi introduce indexările pentru 
identificarea fiecărui bit: l 


using System; 


namespace indexari 
{ 
Class Biti 
{ 
inti] b; 
int lung; 
public Biti (int lung) 
{ bys 
if (lung < 0) throw new ArgumentException(); 
b = new inti((lung - 1) >> 5) + 1]; 
this.lung = lung; 
) 
public int Lung 
{ 
get { return lung; } 
). 
public bool thislint idx] 


{ A 
get 
{ 
if (idx < 0 || idx >z lung) . 
{ : 
throw. new Index0utofRangeException () ; 
) 
return (b[idx >> 5] & 1 << idx) != 0; 
} 
set 
{ i ; i i 
if (idx < 0 || idx >= Lung) 
{throw new IndexoutofRangeException(); ) 
if (value) 
{ blidx >> 5] Je 1 << idx; } 
else { b{idx >> 5] &= ~(1 << idx); ) 
} 
} 
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class Test 


{ f : 
‘static void Main(string[] args) 

{ 

Biti stare = new Biti(100); azi 
ue; =stare : 

stare[5]=true; stare[97]=s ; l 
Console.Write("Bit de stare poz 97: " +stare[97] ); 
Console.Read(); 

) 

) 


Expresia (lung - 1) >> 5) + 1 determină numărul de 
întregi din vector, făcând împărțirea întreagă a lungimii șirului de biti la 32 
= 25 . Indexarea definită în clasă permite adresare atât în read, cât şi în 


write, testând în acelaşi timp şi încadrarea în lungimea şirului de biti definită 
prin constructor. 


Indexările pot fi definite, cum este gi firesc, pe vectori; în acest caz 
indexarea poate asigura regăsirea prin index a unui element. 


Exercitiu 


Să se definească două indexări pe un vector de persoane, care să 
permită regăsirea unei persoane atât după nume, cât şi după marcă. 


Rezolvare 


Căutarea în vector se poate face cu metoda Array. Indexof (vp, p), 
definită în clasa Array; ea primeşte vectorul de persoane şi ape ca 
căutată şi returnează poziția elementului în vector, sau “-1” când elementu 
nu este găsit. Metoda se bazează pe funcţia Equals (obj ect. altul) ; oa 
testează ca obiectul primit este de acelaşi tip cu obiectul curent Şi în plus, 
îndeplineşte condiția de egalitate specifică fiecărui tip de obiect. 


Clasa object din care sunt derivate toate celelalte clase fumizează 
variante implicite pentru funcţiile GetHashcode() si Equals(), ae 
obiectele particulare ( clasa Pers, in exemplu nostru) trebuie să le 
redefinească, pentru a preciza cum se va genera codul de hashing, respectiv 


cand doua astfel de obiecte se considera a fi egale. 


În cazul nostru, codul de indexare s-a obținut pornind de la Marca, iar 
la căutare două persoane se consideră "egale" dacă fie mărcile, fie numele 
lor corespund. În felul acesta putem căuta o persoana fie după marcă, fie 


după nume. 
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private void InitializeComponent () 


{ 


De data aceasta, aplicația va fi construită ca aplicaţie Windows, .nu 
de tip consolă. Pe o formă de vizualizare au fost puse două textbox-uri, unul 
pentru Marca, altul pentru Nume şi două butoane, pentru Adaugare, respectiv 
Cautare. i 


this.tb_ Marca = new system. Windows .Forms.TextBox() ; 
this.tbh_Nume = new System.Windows.Forms.TextBox(); 
this.Adaug = new System. Windows. Forms . Button ({); 
this.Cauta = new system. Windows . Forms .Button (); 


n la oO clasă Pers, dotat p h S en ; 
onstru > this usp d ayout (); 


definit o altă clasă BdPers, care în esență este un vector de obiecte de tip // 
Pers. Ea aduce în schimb, două indexări, una după nume şi alta după marcă. // tb_Marca 
Aşadar pot fi date mai multe indexări, dacă ele diferă prin prototip (în if 
cazul nostru, una primeste int, alta string) . | tb Marca.Location = new System.Drawing.Point(24, 32}; 
tb Marca.Name = "tb Marca"; 
ee tb _Marca.Size = new System. Drawing.Size(80, 20); 
dale beaver: this.tb Marca.TabIndex = 0; 
i : this.tb Marca.Text = "tb Marca"; 
System.Collections; // 
System. ComponentModel ; // tb_Nume 
using System. Windows. Forms; // dă 
using System.Data; tb_Nume.Location = new System.Drawing.Point (152, 32); 
namespace indexPers this.tb_Nume.Name = “tb_Nume"; 
{ Si: this. tb_Nume.Size = new System. Drawing.Size(208, 20); 
; this.tb_Nume.TabiIndex = 1; 
PRE class Formi : System.Windows.Forms. Form this.tb_Nume. Text = "tb_Nume"; 
private System. Windows. Fofms.Button Adaug; fi Adaug 
private System.Windows.Forms.TextBox tb_Marca; // 


private System.Windows.Forms.TextBox tb_Nume; 


: : this.Adaug.Location = new System.Drawin .Point (24, 64); 
private System. Windows .Forms .Button Cauta; 2 ss i j i j 


thi's.Adaug.Name = "Adaug"; : 
this.Adaug.Size = new System.Drawing.Size(80, 23); 
this.Adaug.TabIndex = 2; 

this.Adaug.Text = "Adauga"; 

this.Adaug.Click += : 


private System. ComponentModel . Container components = null; 


public Forml () 


{ A . 
SIE ; System. EventHandler (this.Ad [ei Kis 
InitializeComponent (); // iau fanta Se analen s.Adaug_Click) 
BDP=new BdPers(); // Cauta 
} // ; 
E : ; ; Cauta.Location = new System. Drawing. Point (208, 64); 
protected. override void Dispose( bool disposing ) this.Cauta.Name = "Cauta"; 
A if( di A this.Cauta.TabIndex = 3; 
i isposing ) this.Cauta.Text = "Cauta"; 


í T EDE ( aes this.Cauta.Click += 
F components != null) . z new system. EventHandler (this.Cauta_Click); 
; // 
components.Dispose(); // Forml 
oo 77 | | 
AutoScaleBaseSize = new System.Drawing.Size(5, 13); 


base.Dispose( disposing ); ClientSize = new System.Drawing.Size(376, 109); 
this.Controls.Add(this.Cauta); 
this.Controls.Add(this.Adaug); 


this.Controls.Add(this.tb_Nume); 
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this.Controls.Add(this.tb Marca); 
this.Name = "Formi"; 

this.Text = "Forml"; 

this. ResumeLayout (false); 


) 


#endregion 


[STAThread] 
static void Main) 
{ 3 $ 
Application.Run (new Form1()); 
) : 


public BdPers BDP; 
ivate void Adaug Click (object sender, System.EventArgs e) 


int m=Convert. Tolnt32 (tb_Marca. Text, 10); 
BDP.vp[BDP.crt]=new Pers (m, tb_Nume. Text); BDP.crt++; 
} 


private void Cauta Click (object sender, System.EventArgs e) 
{ 


Pers p; 
if( th_Nume.Text=="" && tb _Marca.Text!="" ) 
p=BDP [Convert .ToInt32 (tb Marca. Text) J; 
else if ( tbh_Nume.Text!="" && tb Marca. Text=="") 
p=BDP [tb_Nume. Text]; 
else 
{ | 
MessageBox. Show 
("Cautare dupa o sg caracteristica!"); 
p=new Pers(0,""); 
) 


tb_Marca.Text=p.Marca.ToString(); tb_Nume.Text=p.Nume; 


public class Pers 
( s 

© public int Marca; 

public string Nume; 

public Pers(int m, string n) (Marca=m; Nume=n;) 


public override int GetHashCode () 
{ return Marca.GetHashCode(); } 
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public override bool Equals(object altul) 
( return (altul is Pers) && Equals((Pers) altul);} 


public bool Equals (Pers altul) 


{ 
return Nume == altul.Nume || Marcas= altul.Marca; 


} 
} 


public class BdPers 


{ 
public Pers [] vp; 
public int crt; int dim; 
public BdPers() 
{ 
dim=100; crt=0; 
vp=new Pers [100]; 
} 
public Pers this[int m] 
{ 
get 
{ 


Pers penew Pers(m,""); 

int poz = Array.IndexOf(vp,p); 

return (poz != -1 ? vplpoz]: 
new Pers(0,"<Anonim>") ); 


) 


public Pers this[string n] 


{ 
get 
{ 
Pers p=new Pers(0,n); 
int poz = Array.IndexOf(vp,p); 
return (poz != -1 ? vp[poz]: 
new Pers(0,"<Anonim>") ); 
} 
} 


Lucrând cu mai multe clase, trebuie să reamintim că Form1 trebuie sa 


fie declarată totdeauna ca primă clasă, pentru a fi prelucrabilă prin Designer. 
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i GO Oras . 1 


poeme meaneaea sean emma 


“Când O iată daro clasă nu este "văzută" în editor la Gei. i 


ina H 
i ' după numele obiectului, înseamnă probabil că este private şi deci : 
i iapa bal direct. : 
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VALIDAREA DATELOR. GESTIUNEA ERORILOR SI 
EXCEPTIILOR 


1. Validarea datelor introduse într-un formular 
2. Gestiunea excepțiilor 


1. Validarea datelor introduse într-un formular 


Am văzut deja cum utilizatorul poate fi ghidat să completeze un 
formular într-o anumită ordine a câmpurilor. Evident, se va pune şi 
problema validării conținutului câmpurilor; când varietatea valorilor 
posibile pentru un câmp este redusă, controale precum ListBox sau 
ComboBox oferă o variantă destul de comodă de implementat. Când însă 
domeniul valorilor este foarte mare sau infinit, este nevoie de funcții de 
validare specifice, uneori corelând valorile înscrise în mai multe câmpuri, 
spre exemplu şcolile absolvite corelate cu vârsta unei persoane. 


Validare simplă 


În subcapitolul privind Gestiunea excepțiilor vom vedea o modalitate 
standard de gestiune a situațiilor neprevăzute şi a erorilor, aplicabilă şi 
erorilor de, validare, bazată pe utilizarea blocurilor try şi catch. Aici însă, 
vom dezvolta şi alte modalități specifice de validare a datelor utilizate de o 
aplicaţie, folosind componente specializate şi proprietăţi ale obiectelor. 


Controalele dispun de proprietăți şi recunosc evenimente. ce pot fi 
corelate direct cu validarea erorilor. Spre exemplu, punând pe true 
proprietatea causesValidation a unui control sau a formei se solicită ca în 
momentul sosirii pe control să se declanşeze funcţia de validare asociată 
controlului care tocmai a pierdut focus-ul., 

Validarea presupune în acest caz execuţia funcțiilor ‘declavate pentru. 
tratarea evenimentelor Validating și Validated. 

Evenimentul validating se produce la încercarea de părăsire a unui 
control pentru a trece pe un: alt control care are proprietatea 
Causesvalidation pusă pe true. 


Exercitiu 


Să se scrie funcția de validare a vârstei unei persoane pentru încadrare 
în intervalul [1, 100]. 
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Rezolvare: ;. 


Pe un formular se adaugă un textbox varsta şi un buton. Butonului i 
se pune” proprietatea CausesValidation pe true, iar textbox-ului i se 
adaugă un handler pe evenimentul validating: 


private void Varsta _Validating 


(object sender, System. ComponentModel . CancelEventArgs e) 
{ 


“string vs =( (TextBox) sender) .Text; 


int vi =System.Convert.ToInt32(vs,10); 
it (vi<0 || vi>100) 
{ 
e.Cancel = trua; 
MessageBox.Show("Varsta trebuie sa fie intre 0-100", 

"Eroare", MessageBoxButtons . OK, MessageBoxIcon.Warning ); 

y Ha ; 
) 

La încercarea de părăsire a câmpului vars ta, când valoarea înscrisă nu 
aparține intervalului fixat, evenimentul (indicat prin parametrul funcției ) 
este revocat (a.Cancelutrua;), preîntâmpinând trecerea focus-ului : pe 
buton; cursorul este readus automat în câmpul vârsta pentru a introduce o 
valoare corectă. rer i 


Valoarea înscrisă în câmp a fost identificată mai general, pomind de la 
cast pe obiectul care a emis mesajul, dar putea fi simplu referită prin 
Varsta. Text. | | 


Evenimentul Validated se declanşează după Validating, dar nu înainte 
de părăsirea controlului şi numai dacă nu a fost revocat evenimentul 
Validating. l i l 


Validarea simplă e utilă pentru testarea izolată, doar a unui control; 
pentru validare încrucişată acest mecanism e dificil de gestionat deoarece: 

e ‘nu știu unde se va duce utilizatorul, deci causesValidation trebuie 
pusă pe true la toate celelalte controale, altfel efectul ar depinde de 
reacţia utilizatorului; | 

* nu acționează și pentru toolbar și meniuri bară; 

„e in cazul validărilor mai complicate produce blocaje în lanţ, fiecare 
control cerând şi aşteptând să fie validat controlul precedent. 
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“Validări încrucişate .. 


} 


Pentru că de cele mai multe ori. validarea presupune corelarea 
valorilor mai multor câmpuri, acest lucru este imposibil de realizat la 
părăsirea unui câmp, deoarece nu ştim în ce ordine a preferat utilizatorul să 
introducă datele în câmpuri. De altfel, momentul validării trebuie atent 
stabilit, deorece pus prea devreme nu dispunem de toate datele introduse, 
necesare validărilor complexe, iar pus prea târziu, corectarea unei erori 
depistate ar însemna foarte multe câmpuri de reintrodus. . as 

Ca test, vă propunem validarea încrucişată efectuată la tentativa de 
salvare a datelor, când se presupune că utilizatorul a introdus valori pentru 


toate câmpurile obligatorii. p 
Exercitiu 


„Să se dezvolte exemplul de mai sus privind validarea vârstei unei 
persoane asigurând şi . corelarea vârstei cu. informaţia privind şcolile 
absolvite. 


Rezolvare 


e În general, : ne asigurăm mai întâi că: toate controalele şi forma au 
proprietatea CausesValidation pusă pe false, pentru a nu declanşa 
validări individuale, în buclă închisă. = E i i 

e Pe butonul salvare punem apelul funcției de validare, ce conţine toate 
clauzele dorite: - EENES i ii 

private vöid btnSalvare_Click (object sender, EventArgs. e) 

{ SE m 
string vs = Varsta.Text;.. string mes = ""; 
bool err = false; 
int vi =System.Convert.ToInt32(vs,10); 
if(vi<o || vi>100) l 

{ 


mes+="\nVarsta in afara intervalului 0-100"; 


err=true; 
} ; ` 
if( vi<15 && Scoala.Text=="Facultate") 

t LI 
mest+="\nVarsta nu se coreleaza cu scoala"; 
err=true; 

} 


if(ierr) ;//... salvare date 
else MessageBox. Show (mes) ; 
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O alternativă pentru cazul în care sunt multe erori de raportat; iar 
urmărirea lor ar fi greoaie, se bazează pe serviciile unui control de tip 
ErrorProvider, extras din ToolBox. ; 

Spre “exemplu, pentru corelarea vârstei cu ultima şcoala absolvită, se 
procedează astfel: TE ae , F 
e se construiesc controalele de bază, un TextBox varsta şi un ComboBox 
Scoala; z i DAR ge 
e se încarcă pentru ComboBox proprietatea Items / Collection cu 

valorile posibile (Elementara, Gimnaziu, Liceu, Facultate); să 
e se aduce în partea de jos a formei, un control ErrorProvider, căruia i se 
" stabileşte proprietatea BlinkStyle pe” valoarea 

BlinkIfDifferentError; beneficiind de tehnologiă componentelor, el 

va putea anunța celelalte controale de prezența sa; ee i 
e | : i şi Scoala vor afişa o 

prin care se indică 
textul initial de afişat în cazul unei erori; stabilirea textului de afişat pe 
eroare are rolul de a marca cu un icon de avertisment toate controalele 
ce vor intra în procesul de validare. Ulterior, textul poate fi schimbat cu 
ajutorul metodei setError aparținând controlului ErrorProvider; 
e controalele Varsta şi Scoala vor afişa chiar din faza .de proiectare în 
designer, în dreapta lor, şi un icon de avertisment, care la momentul 
execuţiei va clipi la producerea unei:noi erori de validare, iar la trecerea 
mouse-ului va afişa ca tooltip mesajul de eroare stocat în acel moment în 
proprietatea Error on errorProvider a controlului respectiv; -: 
e pe butonul salvare punem apelul funcţiei de validare, ce conţine toate 
clauzele dorite: . SS ti-e i ii 


- private voia btnSalvare_Click(cbject sender, EventArgs e) 
string vs = Varsta.Text; na . 
int vi =System.Convert.ToInt32(vs,10); 
if(vi<0 || vi>100) 
errorProviderl.SetError’ 
(Varsta, "varsta in afara intervalului 0-100"); 
else : ee. i S 
if( vi<15 && Scoaiâ: Text=="Facultate") 
{ 
errorProviderl.SetError : 
( Varsta, "Varsta nu se coreleaza cu scoala"); 
errorProviderl.SetError 
{ Scoala,"Scoala nu se coreleaza cu varsta"); 


} 
else 
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nea erorilor si-exceptiilor 


{ //.. „. salvare date 
errorProviderl.SetError(Varsta,""); 
errorProviderl.SetError (Scoala,""); 


Când în proprietatea Error on errorProvider există mesaj null, nu 
se afişează nici icon-ul de avertisment, lucru care se întâmplă când nu s-a 
produs nici una din condiţiile de eroare., 


La umplerea cu spații a numelui funcției apelate pe un eveniment se 
realizează atât unsubscribe; adică detaşarea handlerului de la evenimentul 
respectiv, cât şi ştergerea codului sursă al funcţiei, lucru care poate conduce 


la pierderea de text sursă. 


2. Gestiunea excepțiilor 
Soluţia obiectuală pentru gestiunea situațiilor neprevăzute, de genul 
depăşirii memoriei alocate, încercării de a citi dintr-un fişier care nu mai 
există etc., este implementată prin intermediul excepțiilor. Limbajele de 
programare care au aderat la platforma. .NET trebuie să implementeze şi 
gestiunea excepțiilor. .. Cott Od. eects ie 


Blocurile try sicatch |, -.. 

În C# cea mai simplă modalitate de a gestiona o eroare constă în a 
grupa instrucțiunile suspectate că ar putea produce o eroare într-un bloc try. 
Acest lucru sugerează o încercare supravegheată a execuției instrucțiunilor 


respective, captând eventualele. erori şi tratându-le într-un bloc: catch, 
asociat blocului fry. 
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try 
{ 


// instrucţiuni suspectate că ar putea produce excepții 


// instrucțiuni de tratare a eventualelor excepţii 


Exceptiile pot necesita tratamente diferenţiate în funcție de tipul lor; 
spre exemplu o eroare de conversie a unui text în număr întreg ar putea fi 
tratată punând ca rezultat o valoare implicită sau cerând reintroducerea , 
în timp ce o eroare de depăşire a capacității de stocare a elementelor unui 
vector se poate rezolva redimensionând vectorul sau oprind execuţia 
programului. În consecință, este util să identificăm tipul erorii şi eventual să 
oferim mai multe blocuri catch conţinând cod de tratare distinct pentru 
fiecare tip de eroare în parte. 


try. 
; // instrucțiuni suspectate că ar putea produce excepţii 
bo. a i oP gn A : 
catch (ExceptionType A) 
{ 
// instructiuni de tratare exceptii tip A 
} ; pai 


ener ey ne ae B) 
{ Mes ; 
// instrucțiuni | aa: tratare excepții tip B, 


[i 


) 
- Vom lua ca exemplu o aplicație Windows C# care împarte doi întregi, 
fumizând un rezultat întreg. Erorile cele mai frecvente se produc în zona de 
conversii si calcul, astfel încât aceste instrucțiuni le grupăm într-un bloc 
try. Astfel, funcţia de tratare a apăsării pe butonul de calcul va putea fi 
descrisă în maniera următoare: 


private void Divide_Click (object sender, System.EventArgs e) 


int a,b,r; 
try ` 
{ 
a=int.Parse(txtA.Text); b= int.Parse(txtB.Text); 
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r=a/b; 
txtR.Text=r.ToString(); 
} 


catch(FormatException fmtExc) 
{ 
txtR.Text="Eroare"; // afisare in TextBox 
MessageBox. Show ( l 
"Eroare in formatul de intrare. Reintroduceti!" 
fmtExc .Message) ; 


) l 
catch (DivideByZeroException dvdExc) 


{ 
txtR.Text="Eroare";// afisare in TextBox 
MessageBox.Show("Impartire la zero !", 
AavdExc .Message) ; 

) 


Sunt captate două categorii de erori: erori de conversie format (clasa 
FormatException ) şi erori de împărțire la zero ( clasa 
DivideByZeroException ), cărora le corèspund blocuri catch distincte. 


Observații. 


e Declararea variabilelor a, b, x trebuie să se facă în afara blocului try 
dacă ele sunt folosite şi în afara blocului ( adică în blocul catch). , 
e Operatiile in virgulă mobilă nu ridică excepții, ci le rezolvă intern, după 
următoarele reguli: 
— dacă valoarea rezultată este prea mică pentru forma de 
reprezentare, ea este afişată ca +0 sau -0; 
— dacă valoarea rezultată este prea mare, ea este afișată 
Infinity; 
— dacă operaţia cerută este ilegală se afişează NaN (Not a Number). 


Biblioteca de clase .NET oferă mai multe clase asociate diferitelor 
tipuri de’ excepții; de obicei excepţiile sunt organizate în ierarhii, pe baza 
derivării unora din altele. Spre exemplu, excepția DivideByZeroException | 
este derivată din ArithmeticException, care la rândul ei este derivată din 
SystemException, derivată in ultimă instanță din clasa generică 
Exception. 
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Din punctul de vedere al bibliotecii de clase, erorile sunt împărțite, pe 
cel mai înalt nivel, în două categorii: 
° ApplicationException — excepții de aplicaţie, generate de 
| aplicaţiile utilizator; | 
æ SystemException - excepții de sistem, generate de către maşina 
„virtuală, Common Language Runtime. 
Ambele sunt derivate din clasa generică Exception. Din punctul de vedere 
al limbajului, Exception este un obiect care incapsuleaza informatii despre 
eroare intalnita, informatii care ar putea ajuta la tratarea erorii. 


_ Încercarea de rezolvare-a unei excepţii se bazează pe specificitatea 
erorii, adică se caută un bloc catch specific erorii produse şi numai dacă 
acesta nu există se caută blocuri catch asociate excepțiilor plasate din ce în 
ce mai sus în ierarhia de derivare.: Din această cauză se recomandă şi 
plasarea blocurilor catch în ordinea de la erori specifice către erori din 
ce în ce mai generale: wh 


Cand exceptia se produce in interiorul mai multor apeluri succesive 
de functii, netratarea excepţiei în apelant declanșează propagarea ei în sus 
Către apelant si aşa mai departe până la nivelul cel mai înalt, Common 
Language Runtime, care presupune implicit oprirea execuţiei aplicaţiei. 

Spre exemplu un bloc catch de forma celui de mai JOS tratează orice 
excepţie conformă cu Common Language Specification: 


catch (Exception exc) 

{ 

string msg = 
String.Format ( "Message: {0}\n Stack Trace:\n 41)”, 
exc .Message, exc.StackTrace ); 


ze % 90 


Validarea datelor. Gestiunea erorilor si exceptiilor 


MessageBox. Show (msg, exc.GetType().ToString()); 
) 


în timp ce un bloc catch fără parametri tratează orice eroare chiar 
neconformă cu specificatia limbajelor care au aderat la platforma .NET: 


catch 


{ 
// tratare exceptii în general ; 


Un bloc try trebuie să aibă asociat cel putin un bloc catch; dacă nu, 
el trebuie măcar să se asocieze cu un bloc finally, care să-i motiveze 
utilitatea. 


Blocul finally 


Blocul finally este unic, spre deosebire de catch care poate fi 
multiplu. El descrie operaţiile ce trebuie să se execute îndiferent dacă o 
excepție s-a produs sau nu şi urmăreşte aducerea la o stare coerentă şi 
consistentă a aplicaţiei, indiferent de succesul sau insuccesul acțiunilor din 
txy şi eventualele blocuri catch. 

Spre exemplu, eşuarea alocării întegrale a unui pachet de resurse nu 
trebuie să lase ca ocupate resursele ce au fost deja alocate. 


try 
{ ee ; o 
// instrucţiuni ce fac alocări resurse 
) 
finally 
{ : ` 
// eliberare resurse 
) i 


Construcţia de mai sus putea să conțină şi blocuri catch, blocul finally 
executându-se totdeauna, indiferent care dintre blocurile try sau catch s-a 
executat. 


Instrucţiunea throw 


Instrucţiunea throw este folosită pentru a declanșa explicit o 
excepție; programatorul poate face acest lucru din două motive mai 


frecvente: 
9] 


Validarea datelor. Gestiunea erorilor şi excepțiilor 


e nu are cod specific de tratare a unei excepții, dar dorește s-o 
capteze pentru a o notifica intern (utilizatorii sau obiectele 
aplicaţiei să fie incunostinfate într-un anume fel asupra producerii 
ei), după care o “rearunca" pentru a fi tratată după modalitatea de 
tratare existentă în sistem. Spre exemplu, ceas, un obiect construit 
de utilizator este dotat şi cu o proprietate numită Mesaj, care 
stochează informaţii colaterale asociate obiectului; fixarea unei ore 

zn 


inexistente pentru "alarmă poate fi notificată printr-un mesaj 
adecvat. . 


catch (Exception exc) 


{ 
ceas.Mesaj = "Ora neadmisibila"; 
throw; 


) 


e crează o instanță a unei excepții existente în sistem sau chiar o 
excepţie specifică aplicației și o "aruncă" spre tratare, pentru a 
folosi acelaşi mecanism de gestiune a excepțiilor ca şi framework-ul. 


string msg = "Valoare in afara intervalului admisibil"; 
ArgumentOutOfRangeException exceptiaMea = 

new Arii UC CULO fRangeErception(msg); 
throw exceptiaMea; 


După cum se observă, constructorul clasei aferentă excepţiei are o 
versiune supraîncărcată, care primeşte valoarea particulară a mesajului de 
expus la producerea excepţiei respective; această versiune se recomandă ca 
alternativă la default constructor. 


Să presupunem acum că dorim să declarăm o excepţie personalizată, 
specifică aplicaţiei; pentru aceasta, în aplicația anterioară, după terminarea 
descrierii clasei Form1 se descrie şi clasa aferentă tipului excepţiei dorite. 
Exceptiile aplicaţiei sunt derivate direct din applicationException şi 
trebuie să aibă şi default constructor. 


public class ExceptieDeLuna 
{ 
public ExceptieDeLuna (){ } 
public ExceptieDeLuna (string mesaj) 
base (mesaj) 
{ 
} 
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Validarea datelor. Gesuunea erernor yi eacepiinus 


Pe un eveniment (aici click pe un buton de validare) se face preluarea 


“valorii de validat, iar la momentul validării se generează sau nu, după caz ŞI 


excepţia specifică aplicației. 
private void validare Click (obiect sender, EventArgs e) 


E 


string luna = DenLuna. Text; 
switch (luna) 


{ 
case "ian": case “feb":// 
break; 
default: 
ExceptieDeLuna exc = 
new ExceptieDeLuna("Luna se da in litere"); 
throw exc; 
} 
} 
catch(ExceptieDeLuna exc) 
t x ` 
MessageBox. Show (exc .Message, "Eroare introducere") ; 
) 


Desigur mesajul putea fi dat direct în switch, dar mecanismul cu 


excepții e mult mai general, oferind în plus: 
e posibilitatea notificării excepţiei şi altor obiecte; 
e coexistenta cu alte excepții ce se pot produce în acelaşi bloc try, 


tratabile în alte blocuri catch. 
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GESTIUNEA MOUSE-ULUI ȘI A TASTATERII - 


Validarea datelor. Gestiunea erorilor şi excepțiilor 


Nu este indicat un apel throw din interiorul unui bloc finally, 
deoarece în acel moment există deja încă o excepție în aşteptarea captării şi 
tratării. 


ei 


. Gestiunea evenimentelor generate de mouse 


Atunci când eroarea poate fi tratată pe loc, în blocuri if-then - else 2. Gestiunea evenimentelor generate de tastatură 


incluse, nu se recomandă excesul de utilizare a excepțiilor, deoarece 
fragmentează codul şi face execuţia programului mult mai lentă. 


1. Gestiunea evenimentelor generate de mouse 


Dintre perifericele punctuale, probabil mouse-ul rămâne cel mai 
utilizat, deşi există combinaţii de taste şi săgeți pentru toate funcțiile 
realizate cu mouse-ul, aproape că- nu ne putem imagina un program cu o 
interfață grafică evoluată, fără utilizarea acestuia. ' 

Controalele, inclusiv Form, interceptează activitatea mouse-ului dacă 
ele au proprietățile Enable şi Visible pe valoarea True. Chiar trecerea cu 
mouse-ul pe deasupra unui control este înregistrată şi poate fi aleasă ca 
eveniment reper pentru derularea unor acţiuni. Dacă un control chila este 
dezactivat, atunci controlul parent recepționează evenimentul legat de 
mouse. Când mai multe controale sunt suprapuse, numai cel de deasupra 
primește acest tip de eveniment. 

În general, se recepționează tin eveniment de mouse doar când mouse- 
ul se află deasupra controlului, dar acțiuni complexe de genul drag & drop 
pot "captura" mouse-ul, urmărindu-l şi în afara suprafeței controlului, chiar 
şi în afara ferestrei aplicației. 

„__ Clasa control defineşte nouă evenimente legate de mouse, dintre 
care patru .sunt cele mai frecvent folosite:. MouseDown, MouseUp, 
MouseMove şi MouseWheel. Lor le corespund funcţiile de tratare moştenite 
din clasa Control: OnMouseDown, OnMouseUp, OnMouseMove şi 
OnMouseWheel. Ele dispun si de un delegat.de tip MousegventHandler la 
care pot fi ataşate şi detaşate (operatorii += şi -= ) tunepi de tratare a 
evenimentelor de mouse, scrise de programator. 

Funcția de tratare a unui eveniment de tipul celor ties. mai sus 
furnizează şi un parametru de tip MouseEventArgs ce contine informatii 
detaliate despre evenimentul produs: oe 

e x şi y —.coordonatele mouse-ului la momentul producerii 

evenimentului; 

e MouseButtons — enumerare: de tip MouseButtons ce indică 

butonul (butoanele mouse-ului) utilizat(e); 

e clicks — single sau double click (1 sau 2); 
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„__ Gestiunea mouse-ului şi a tastaturii 


_..© „Delta — un întreg pozitiv sau negativ ce indică sensul și 
dimensiunea deplasării rotitei mouse-ului. 


Pentru a demonstra înlănţuirea evenimentelor de mai sus vom presupune 
o aplicaţie de "mouse tracking”, adică de urmărire a traseului urmat de 
mouse pe suprafața formei. 


Exercitiu 


Exemplificati folosirea principalelor evenimente bazate pe mouse 
printr-un program care permite extragerea coordonatelor mouse-lui şi 
desenarea cu mouse-ul. Salvați fişierul imagine şi restaurați-l ulterior pentru 
a continua desenul. | 

Scrieţi codul necesar imprimării ulterioare a unui astfel de desen. 


Rezolvare 


Într-o aplicație C# Windows. Application dimensionăm forma astfel 
încât să dispunem de o suprafața suficient de mare pentru desen; stabilim 
BackColor White, pentru a fi uşor vizibil desenul. Declarăm o variabilă 
booleană care arată starea creionului (apăsat, ridicat) şi o listă de puncte, 
colectate atâta timp cât ținând apăsat mouse-ul ne deplasăm cu,el pe 
suprafața de desen. Eventual o bară de stare va afișa, spre confirmare, starea 
creionului. - o ; 


ArrayList lstPcte; ` i 
private Systém.Windows.Forms.StatusBar statusBar1;: 
‘bool creionipasat; pa af ee Sag 


In constructorul formei se inițializează variabilele declarate anterior.: - 


public Formi(} 


{ oo, : : 
InitializeComponent () ; 
creionApasat = false; 
lstPctae = new ArrayList (); 

} 


„La MouseDown se adaugă un prim punct (cel original) la colecţie, se 
schimbă starea creionului şi se afişează în bara de stare. . 


private void Forml_MouseDown (object sender, 
System. Windows .Forms .MouseEventArgs e) 
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“punct curent, punctul i 
un creion de culoarea preluată din proprietatea ForeColor a formei. 


tiunea mouse-ului şi a tastaturii 


Point p=new Point(e.X,e.Y); IstPcte.Adă(p); _ 
creionApasat=trua; statusBarl.Text="Creion jos"; 


) a . . 
Pe MouseMove se preia contextul grafic al formei, se retine drept 


furnizat de parametrul functiei de tratare şi se crează 


private void Form1_MouseMove (object. sender, 
System. Windows . Forms .MouseEventArgs e) 
{ 
Graphics g = chis.CreateGraphics (); 
Point petCrt = new Point (e.X,e-Y); 
Pen creion = new Pen(ForeColor) ; 
if ( creionApasat ) : ; 
{ l ; | 
statusBarl.Text="Scrie"; 
if (IstPcte.Count > 1) 
g.DrawLine(creion, 
(Point) lstPcte{1stPcte.Count-1},pctCrt); 
lst Pcte.Add(petCrt); 


) 


) : K ; . a e e , 
Dacă nu este singurul punct din colecţie, se va trasă 0 linie de la 


ultimul punct existent în colecţie la punctul curent, punctul curent este apoi 
adăugat la colecţie, astfel încât cum MouseMove se generează repetat pe toată 
durata deplasării mouse-ului, colecţia să fie completată progresiv. 


Gestiunea mouse-ului şi a tastaturii -| 


Pe MouseUp, ridicăm creion pentru a putea initia un nou şir de puncte 
desenate şi anunțăm acest lucru în bara de stare. 


„private void Formł_MouseUp (object sender, 
System.Windows.Forms.MouseEventArgs e) 
{ . i | 
„creionApasat = false; statusBarl.Text="Creion sus"; 


) 


Un inconvenient major al programului constă în faptul că minimizând 
fereastra constatăm la maximizare că desenul a dispărut; va trebui rescrisă 
funcţia onPaint() astfel încât să redeseneze toate punctele deja stocate. 
Probabil că o soluție eficientă ar fi să definim un masiv .bidimensional de 
puncte, în scară, o linie din matrice preluând toate punctele colecției dintre 
două evenimente MouseDowm şi MouseUp. Am beneficia astfel de facilitatea 
unei colecții de a fi extensibilă punct cu punct, dar şi de dimensiunea stabilă 
a masivelor pentru redesenare, din momentul în care se cunoaşte numărul 
total de puncte ale unei secvențe.. T 

Acest lucru uşurează şi serializarea datelor preluând din ArrayList, 
respectiv deserializarea cu retrasarea punctelor, la restaurare dintr-un fişier. 

Lăsăm la latitudinea cititorului dezvoltarea programului pentru a 
răspunde şi celorlalte cerinţe ale exerciţiului. 


2. Gestiunea evenimentelor seale de tastatură 


Trei sunt evenimentele, sesizate în 1 legătură cu folosirea t tastaturii: 
d KeyDown 
e „KeyPress 
e : KeyUp Tt 
Ele se genereaza exact in ordinea de mai sus si au blocul de parametri 
ai evenimentului de tipuri diferite. KeyDown şi Keyup se produc. la 
elaxarea unei taste, iar handler-ul ora „au argumentul de 


_KeyPress este un eveniment mai special, care se produce la apăsarea 
unei taste, după KeyDown si doar dacă apăsarea” produce o valoare de tip 
caracter ( nu şi la taste funcționale); blocul de argumente al funcţiei de 
tratare este de tip 

Evenimentele de tastatură sunt sesizate numai de controalele active; 
forma primeşte şi ea notificarea evenimentelor de tastatură, dar doar dacă a 
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Gestiunea mouse-ului şi a tastaturii 


pe true,:că doreşte să intercepteze 


Proprietăți stocate în obiectul KeyPressEventargs, 


e Handled - precizează prin true / false dacă evenimentul se 
consideră deja ca tratat şi nu mai trebuie transmis controlului care are 
focus-ul în acel moment. 

e KeyChar — Caracterul aferent tastei apăsate şi care a produs! 

i evenimentul. | o i 


Proprietăți mai importante stocate în obiectul KeyEventargs ' 


ie Aalt -true dacă tasta Alt este apăsată, false altminteri; : 

i e control - true dacă tasta ctrl este apăsată, false altminteri; 
i e -Handled-— precizează prin: true / 'false :dacă evenimentul se | 
i consideră deja ca tratat şi nu mai trebuie transmis controlului care are ; 
i focus-ul în acel moment; ht ; 
| © KeyCode — codul tastei (litere si taste funcționale ) apăsate; poate fi | 
comparată cu una din valorile enumerării Keys. ; 
i e KeyData — codul tastei apăsate, împreună cu pioprietaisă Modifiers | 
; (vezi mai jos); . ; 
i e KeyValue — returnează proprietatea keyData în a cori int; sui, i 
i e Modifiers — returnează ce combinaţie de taste au fost apăsate 
i simultan (ctrl, Shift, Alt) one | 

K ° Shift true > dacă tasta shift este apăsată, false altminteri. l | 


Exercitiu 


Să se elaboreze un program . care utilizează 
Se va. proiecta şi realiza o- aplicaţie NET care 
simulează un PIAN, ce dispune de taste (butoane), dar la care se poate cânta 
şi folosind tastatură calculatorului. i 


Rezolvare 


Aplicația PIAN exemplifică tratarea unitară, la nival de formular a 
evenimentelor keypress pentru tastatură ny click de buton. - 
Observaţii preliminare: + - , . i than fa 
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Gestiunea mouse-ului şi a tastaturii . 
e restiunea mouse-ului şi a tastaturii 


e un handler poate fi invocat de mai multe evenimente ( ex. aceeaşi 
funcție trateză şi click de buton şi click pe optiune meniu ) sau mai 
multe butoane anunță aceeaşi funcţie de tratare Click. 

e uri eveniment poate fi tratat prin invocarea mai multor handlere; la 
rulare poți detasa / ataşa dinamic, handlere; ataşarea unui handler pe 
acelaşi event se face cu +=; detașarea unui handler de la un event se 
face cu-=. i l 


Paşii de realizare: 7 
e Deoarece se va folosi beep-ul de pe procesor, se include un namespace 
specializat pentru accesul la serviciile sistem: 


using System.Runtime.InteropServices; | 


e La începutul clasei Formi se anunță că aceasta va face un import de 

_ funcţie dintr-o bibliotecă legată dinamic, la momentul execuţiei ( e 
vorba de funcția Beep( int nota, int : durata -) folosită Ja 
producerea sunetului ): 


{DilImport (“kerne132.âd11-) ] 


e Se tratează evenimentul KeyPressed la nivel de formă, folosind. funcţia 
următoare: ` l 
private void Form1_KeyPress 


(cbject sender, KeyPressEventArgs e) 
t : A 


int DO = 262,RE = 294,MI = 330, FA = 349, SOL = 392, 
ai LA = 440, SI = 494, DO2 = 524; 


switch(e.KeyChar ) 


{ 
case ‘a': Beep(DO,200); break; 
case 's': Beep(RE,200); break; 
case 'd': Beep(MI;200); break; 
case ‘f': Beep(FA,200); breaks. °° 
case 'g': Beep(SOL,200);break; i` a 
case 'h': Beep(LA,200); break; 
case ‘j': Beep(SI,200); break; 
case 'k': Beep(D02,200);break; 
} `i 


} 


è Formi trebuie să aibă setată true proprietatea KeyPreview, care anunță . 
că forma dorește să primească mai întâi ea informația tastată, pe care o 
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: Gestiunea mouse-ului şi a tastaturii 


va directiona apoi către TextBox-ul care primeşte focus-ul în acel 
moment ( altfel forma nu primeşte input-ul de la tastatură ). 

e Se pune o funcție onButoane() la nivel de formă și ea se declară drept 
handler pentru evenimentul click la nivelul fiecărui buton: 


private void OnButoane (object sender, System.EventArgs e) 


{ 


string nume=( (Button) sender) .Text; 
“int DO = 262,RE = 294,MI = 330, FA = 349, SOL = 392, 
n% LA = 440, SI =.494, DO2 = 524; 

switch (nume ) i 


i case "DO": Beep(DO,200); break; 
case "RE": Beep(RE, 200) ;break; 
case "MI": Beep(MI, 200) ;break; 
case "FA": Beep(FA, 200) ;break; 
case "SOL": Beep(S0L,200);break; 
case "LA": Beep(LA,200);break; 
case "SI": Beep(SI,200); break; 
case "DO2": Beep(DO2,200); break; 

} 


e Se poate specula succesiunea evenimentelor KeyDown, KeyPress (care 
: N a se a EN 

se generează repetat dacă se menține tasta apăsată ) şi Keyup ( generat o 

singură dată, la eliberare tastă ) pentru a modifica durata sunetului. 


Pentru a evita repetarea definirii notelor la nivelul ambelor funcții, 
acestea se puteau defini la nivelul formei, sau şi mai elegant, ca o: 
enumerare : i i 


public enum note { DO=262,RE=294,MI = 330, FA = 349, 
SOL = 392, LA = 440,SI = 494, DO2 = 524); 
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folosită apoi în ambele funcții sub forma: 
„case "DO": Beep ((int)note.D0,200); break; 


Exercitiu 

să se proiectezers si realizeze Sub Sici CH o diae calculator, 
similară celei din Windows Accessories. Tastele funcționale vor fi 
inscripționate cu roşu, iar cele numerice cu albastru; introducerea 
numerelor se poate face de la tastatură sau din butoanele-tastă ale 
aplicației. Toate calculele efectuate la o rulare vor fi salvate într-un fişier 
text, organizat ca pe o bandă de hârtie, putand fi consultate ulterior cu orice 
editor de text. 


Rezolvare 


Pentru a nu complica înțelegerea, dăm mai jos doar scheletul de bază al 
funcţiei de tratare a apăsării pe un buton al calculatorului. 


private void OnButoane (object sender, System.EventArgs e) 
{ 

_Button, b= (Button) sender; string. s = b.Text; 

„„ Switch(s) // taste functionale ia oie 

4 

i zi case "CE"; /* tratare Clear: Entry */ break; 
case "C" ; /* tratare Clear All */ break; 
i similar pentru alte taste functionale 


if ( char.IsDigit(s[0]) ) //taste cifre 
{ ii 


// tratare butoane inscriptionate cu ci fre 


else // operatori de calcul 
{ zi ze 
= double. Parse(tb.Text); 
* switch(oldOp) 
{ 
case "+": /* tratare operator + */ break; 
// similar pentru operatorii - * / 
case "=": x=y; break; 
) 
tb.Text=y.ToString();oldOp=s;init=true; 
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Evident că la apăsarea cifrelor de la tastatiiră, tratarea ar trebui să fie 
similară apăsării: butoanelor calculatorului; din acest motiv se construieşte 
un buton temporar care se inscriptioneaza cu cifra preluată de la tastatură și 
se apelează tot funcţia de tratare a apăsării unui buton. 


private void Formi_KeyPress 
(object sender, KeyPressEventArgs e) 
: // proprietatea KeyPreview a formei sa fie pusa pe true 
Button tmp = new Button(); > 
tmp.Text = e.KeyChar. ToString(); 
e.Handled=true; : 
// marcheaza ca tratat, sa nu ajunga si la textBox !! 
OnButoane(tmp, new EventArgs()); 
// simuleaza apasare de buton 


Uneori este nevoie să redimensionăm forma, pentru a vedea mai bine 
controalele componente; constatăm că la Resize, se măreşte doar fereastra . 


“nu şi controalele; aceasta deoarece controalele au poziții şi dimesiuni fixate 
"în cadrul formei, prin proprietățile lor şi care ar trebui modificate, una câte 


una. Funcţia de mai jos, pusă ca tratare a unei opțiuni din meniu, realizează 
atât dublarea formei, cât şi a controalelor component: Ey 
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private void menvView2X_ Click : te ner 
în (object sender, System,EventArgs e) 
// View 2X dublare imagine cu repozitionare controale 
this.Width*=2; this.Height*=2; 
foreach( Control c in this.Controls) 


{ 


-//' accepta doar modificare la nivel de Location 
c.Location= new Point (c.Location.x*2, c.Location. Y*2); 
c.Height*=2;c.Width*=2; 

// trebuie creat font nou, c.Font fiind imutabil 
Font f= . gr ac * 

new Font (c.Font.Name, 2*c.Font.Size, FontStyle. Bold) ; 
c.Font=f; 
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4 Gestiunea mouse-ului şi a tastaturii 


- Exerciţiu 


Peste o imagine de telefon mobil să se plaseze controale care să 
simuleze funcțiile tastaturii unui mobil: formarea de numere de apel, 
consultare agendă telefonică, apel de număr, compunere mesaj etc. 


Rezolvare 


Opacity este o proprietate a formei; ea controlează transparența 
formei. Se poate specula proprietatea de opacitate, onorată doar de sistemele 
de operare capabile să afişeze pe layere ( Windows 2000, Windows XP şi 
ulterioare) pentru a combina culoarea formei cu cea a ferestrelor de sub ea. 

TransparencyKey este 0 proprietate a formei, care face transparentă 
doar o zonă din fereastră şi anume cea de culoarea declarată drept culoare 
de transparenţă. Zonele transparente din fereastră se comportă ca şi cum n-ar. 
fi, adică dând click pe ele mesajul este recepționat de fereastra de sub 
fereastra formei ! d 

Nu există o proprietate pentru a gestiona transparența unui control; 
se poate totuşi alege pentru proprietatea Backcolor 0 culoare creată cu 
metoda Color.FromArgb(), Care permite stabilirea unui factor alpha de 
transparență. El este detaliat la începutul capitolului de grafică. Spre 
exemplu, butonului adus din ToolBox, inscriptionat Exit şi aşezat peste 
tasta Exit a telefonului i se fixează un factor de transparență 25 (din max. 
255) şi o culoare albă: l 


Exit.BackColor = Color.FromArgb(25,255,255,255); 


Dam în continuare câţiva din paşii mai importanţi pe care trebuie să-i 
parcurgem pentru a răspunde cerințelor de mai sus. 


e Se descarcă de pe site-ul unei firme de telefonie mobilă imaginea 
unui telefon mobil, aleasă astfel încât. să fie bine vizibile tastatura şi 

__ butoanele cu funcţiile de bază ale acestuia. 

e Proprietatea FormBorderStyle pusă pe valoarea None, face ca forma 
să afişeze imaginea fără border, ca şi cum ar fi vorba nu deo 
fereastră, ci numai de imaginea telefonului mobil. 

èe Proprietatea TransparencyKey a formei, pusă pe White, sau pe 
culoarea care se considera ca fundal. 
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__ Gestiunea mouse-ului şi a tastaturii . < 


e Jn constructorul formei, după apelul Initializecomponeat ();:se 
construieşte un obiect Bitmap BG pornind de la imaginea telefonului 
mobil şi se declară ca imagine de fundal pentru formă. 


Exit.BackColor = Color.FromArgb(25,255,255,255); 
Bitmap BG = naw Bitmap("nokia.bmp"); 
this.BackgroundImage = BG; i 


Similar se poate proceda pentru fiecare tastă a telefonului, punând în 
funcția de tratare a butonului asociat codul sursă ce simulează acţiunea 
corespunzătoare. Butonul Exit realizează si ieşirea din aplicație. 


private void Exit_Click(cbiject sender, System.EventArgs e) 
{ 
Application. Exit (); 
} 
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Lucrul cu meniuri şi bare 
LUCRUL CU MENIURI SI BARE | 


1. Meniu principal - MainMenu 

2. Meniuri contextuale - ContextMenu 

3. Controale de tip bară de instrumente — ToolBar 
4. Controale de tip bară de stare - StatusBar 


Există două tipuri de meniuri: principale ( inserabile vizual prin 
controlul MainMenu) şi contextuale ( inserabile prin controlul 
ContextMenu şi activat la execuţie cu click buton dreapta mouse). 

Ambele se pot prelua din ToolBox; prin aducerea pe formular vor ''fi 
plasate în josul paginii, iar la selectare cu mouse-ul se activează pe 
platforma aplicației un mecanism “type here”, de completare vizuală a 
opțiunilor. 

&x (x fiind o literă din denumirea opțiunii precedată de & ) acționează 


` ca accelerator, adică permite selectarea rapidă a opțiunii, cu Alt + x. 


MainMenu este obiect unic, pe când contextMenu poate avea mai multe 
instante, care se ataşează unor obiecte din form; astfel în funcţie de obiectul 
pe care dăm click MouseRight ( adică în funcţie de context ). se va activa 
unul sau altul dintre meniurile contextuale. 
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1. Meniu principal - MainMenu i 


Construirea vizuală a unui meniu principal este extrem de simplă: 


e Se trage controlul MainMenu din ToolBox; el este pus în josul formei; îl 


redenumim în Properties / Name cu numele MenPrincipal 
e Selectém meniul şi completăm opțiunile dorite. 


Pentru a vedea cum putem face același lucru prin program, fără 
ajutorul componentei vizuale, este bine să observăm ce a scris Designer-ul 
pentru noi. În clasa Formi apar membrii de tip MäinMenu, respectiv câte un 


Menultem, pentru fiecare din opţiunile sale: 


rivate System.Windows.Forms.MainMenu MenPrincipal; 
civate System.Windows.Forms.MenuItem menultenl ;, 


In InitializeComponent() sunt instantiati toți membrii formei, 
printre care şi cei referitori la meniu, stabilindu-se şi diversele proprietăți ale 


acestora: . i 


this.MenPrincipal = new System.Windows.Forms.MainMenu () ; 


this .menulteml = new System.Windows . Forms .MenuItem () ; 
this.menuItem1.Text = "Fisier"; 


Tot aici sunt incluşi toți membrii de tip Menultem în colecţia MenuItems a 


meniului principal: 


this.MenPrincipal.MenuItems „AddRange 
i ( new System.Windows.Forms -MenuItem[] 
{ . 
this.menuItem1, 
this.menuItem2 


} 
); 


Dacă o opțiune se descompune pe subopțiuni, atunci acel item are 


propria sa colecţie Menurtems: 


this .menultem2 .Menultems .AddRange 
( new System.Windows: Forms. Menultem[] 
{ > 
this.menuItem3, 
this -menultem4, 
this.menuItem5 


} 
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amintim: aoea h n vatra ita oid a sa 
e Checked — precizează prin true / false starea bifat / nebifat pentru 


Lucrul cu meniuri şi bare 


“În timpul completării opțiunilor dintr-un meniu, pe butonul mouse dreapta 
ni se oferă următoarele posibilități: ; 


1. Insert New — pentru a adăuga o noua opțiune; 

2. Delete — pentru a şterge o opțiune; 

3. Insert Separator — pentru a introduce un separator între opțiuni; 

— care bifat, asigură vizibilitatea şi editarea directă a 
identificatorilor de opțiuni, nu numai a textului afişat de opțiuni 
(caption). Denumind. sugestiv opțiunile avem avantajul că atunci 
când designer-ul va completa numele, unei funcții de tratare a 
opțiunii respective va da un nume funcţiei pornind de la numele 
opțiunii, mărind astfel lizibilitatea programului. 


i Se pot schimba între ele opțiunile deja completate, prin tragere cu 
i mouse-ul. © i 


e E | 
Å amanet ea setata be pane aa ma ea ea NNE stentunestanensunpsecsunraatribecaened amanati rrenenre nenn: 


Meniurile au proprietăți specifice; dintre proprietățile mai importante 


` opţiunile cu bifă (check mark) sau de tip radio button; pentru un 
meniu cu opţiuni de tip radio button, excluderea mutuală a opțiunilor 
ce fac parte din acelaşi grup nu se face implicit, ci prin cod sursă 
furnizat de. programator. Momentul bifării / debifării este de obicei 
cel legat de evenimentul Popup. | e. 

e ownerDraw - true / false, dacă programatorul furnizează cod sursă 
pentru desenarea meniului, în locul celui standard, folosit de 
Windows. pi 

e RadioCheck - cere ca meniul. să; afişeze un radio button în locul 

Pi bifei, când proprietatea Checked.este setată pe true.. l 

s ghorta = „specifică. tastele funcționale pentru acces rapid la 
opțiunile unui meniu. i z - 


F rls aif r 
L An ore 


Evenimente specifice -~ + ia ali Chae? , EEDE 


e Select — declanşat când la execuție selectăm opțiunea din meniu ( cu 
mouse sau cu săgețile de la tastatură); . Be ane a 

e Popup — când se "desfăşoară" meniul; legat de acest eveniment 
putem să actualizăm dinamic meniul, conform noului context. 


e Click —la click de mouse; 
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: Lucrul cu meniuri i bare k 


~Drawltem — generat la desenarea meniului, doar pentru meniurile 

desenate de programator ( proprietatea ownerDraw este true) 

pentru a putea furniza cod de pictare meniu. pos 

. Measureltem — activat când la execuţie se Citeşte sau se scrie 

proprietatea ItemHedght ( prin accesorii get-set). l 

' Handlere-le de tratare a unei opțiuni se pun selectand optiunea şi dând în 

Properties — Events numele funcţiei, apoi completăm în codul sursă ce 
acțiuni dorim să fie executate la producerea acelui eveniment. 


Exercitiu 


Pe o opțiune din meniu View ascundeti / refaceti butonul de actualizare 
date, dintr-o aplicație de introducere date. 


Rezolvare 


Se va proceda aşa cum se descrie mai sus despre lucrul cu meniuri, jar 
pe opțiunea inscripționată show, de nume menuItem3, declarată cu 


proprietatea Checked pe true, se adaugă funcţia de tratare a evenimentului 
Click: 
private void menuItem3: Click ee eM 
i i ( object sender, System. EvedtArgs e): 
button1.Visible = !button1.Visible,; E 
menuItem3.Checked = !menultem3. Checked; 


button1 este şi el un Control existent deja pe formă; se observă că nu 
este nevoie de if pentru a comuta: dintr-6 stare în alta o proprietate cu două 
Valori,. true şi false, ci putem doar:să. "negăm" starea existentă la un 
moment dat. a l 

La crearea meniului se poate stabili şi combinația de taste ce permite 
accesul rapid la opțiunea din meniu; în acest sens se va folosi proprietatea 
Shortcut. Combinația poate fi. apoi folosită, dar afişarea ei pentru 
informarea utilizatorilor, nu. este implicită, ci depinde de proprietatea 
ShowShortcut, care poate fi true sau false. - 


_Dand Enter cand este activat mecanismul TypeHere de completare a 
unui meniu, se adaugă un separator; un Separator între opțiuni se poate 
introduce şi folosind MouseRight şi alegând Insert separator. 
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IE iii CRS S cand a a ROI m SR DA RE II z 
Se pot muta cu mou nu numai Opțiunile, atunci cînd vrem să le 
reordonăm, ci putem muta chiar categorii întregi, selectându-le şi 
deplasându-le cu drag & drop. ` l 


2. Meniuri contextuale - ContextMenu 


Se trage controlul ContextMenu din ToolBox; el este pus în partea 
de jos a formei ; îl redenumim (cu Properties / Name) contextMenuForma, 
pentru că dorim să se activeze pe MouseRight click, dat pe forma. ` 
Meniurile contextuale pot fi ataşate câte unui control; asocierea 
meniului cu un control. se face punând în proprietatea ContextMenu @ 
căruia dorim să-i ataşăm' meniul, numele meniului contextual 
dorit. Spre exemplu, în proprietatea ContextMenu a formei se citează 
meniul contextMenuForma, creat anterior. l 

Completarea opțiunilor meniului : selectăm meniul contextual din 
josul formei; în partea superioară a formei apare un mecanism “type here”, 
care permite editarea opţiunilor meniului ca şi la MainMenu; se pot da 
opțiuni pè verticală şi pe orizontală. 

Pentru tratarea evenimentelor pe opțiunile care nu se mai descompun, 
procedăm ca la meniul principal. 


Exerciţiu .-. 


Ataşaţi meniuri flotante unor obiecte grafice dintr-o aplicaţie formular: 

e pe un meniu contextual al unui TextBox să se introducă posibilitatea de 
a alege o culoare de scriere şi o culoare de fundal; 

e pe un control Label, meniul contextual să dea posibilitatea alegerii 
culorii, fontului ete: > apei e Ties zA ier 


Rezolvare 
1. Se aduce controlul label; i 005 0o ai 
2'se construieşte meniul contextual conMenLabel, având ca opțiune 
: Culdare şi suboptitini Rosu, Verde etc. ee i 
3... Se leagă meniul contextual de controlul labell cu. Properties / 
ContextMenu, selectând din ComboBox-ul afişat de sistem (sau 
scriind pur şi simplu) numele meniului dorit, conMenLabel: 
„4, Se pune funcţia de tratare pe click suboptiune "Culoare rosie” fie din 
. Properties / Events Click, fie dând click de mouse în timpul editării 
meniului, când avem opțiunea selectată ; apoi-se editează codul: 
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labeti.BackColor =. System.Drawing.Color.Red; : 


Dacă se dorește ca opțiunea să ofere posibilitatea de a stabili orice 
culoare din paleta de culori se poate invoca un control specializat: 


ColorDialog colorDialogi = new ColorDialog(); 
L£(colorDialogl. ShowDialog () E DialogResult. OK) 
{ 
: „label1.BackColor = colorDialogi.color;, 
a; 
Acest cod instanțiază un dialog de alegere a unei culori: din paleta de 
culori şi preia culoarea selectată. în controlul ColorDial og drept 
culoare de fundal pentru controlul label1. 
_ 5. Similar se pune handler pe click suboptiune "Font Sans Serif " Şi se 
editează codul: 


label1.Font= 
i new System. Drawing. Font i 
( "Microsoft Sans Serif", 16:25F, 
System. Drawing. FontStyle.Bold, 
System.Drawing.GraphicsUnit.Point, 
(System.Byte) (0)) Ă 
i i E 


Dacă se doreşte ca opțiunea să ofere posibilitatea de a stabili orice - 
font din cele disponibile, poate fi invocat un control specializat: : 


FontDialog fontDialogl = new FontDialog(); oc + 
if (fontDialog1.ShowDialog() == DialogResult.OK) 


bbe tre E y SAT rade as 
=o i!  label1.Font = fontDialgl.Font; 
Pentru testarea noilor setări, se cere rescricerea şi textului afişat de 
etichetă : i 
labell.Text="Nou"; they fe Oa at 


Modul de utilizare a meniului conMentabel, prezentat mai sus, are 
dezavantajul că este legat de un singur control, cel de tip Label. În general, 
un meniu contextual se atașează simultan mai multor controale; spre 
exemplu, se doreşte ca nu numai eticheta, ci şi un textbox să beneficieze de 
acest meniu de stabilire a culorii de fundal şi. a fontului de afişare; vom 
numi în acest caz meniul contextual mai general, contextMenul. -. 

El va fi ataşat ambelor controale (label1 şi textBox1), selectându- 
le pe:amândouă deodată şi inserând la proprietatea ContextMenu numele 
meniului popup, contextMenul. l : 

o o H2 


4: Lucrul cu meniuri şi bare 


aan NY 


d: i : A Se RR EET mate ee mel 
“Din codul sursă de tratare a evenimentului menurtemclick vă trebui 
eliminat identificatorul 1abe11, deoarece de data aceasta efectul poate viza 
fie controlul Label, fie controlul TextBox. El trebuie înlocuit cu un control 
generic şi anume cel aflat sub mouse la momentul activării meniului 
contextual. 

Soluţia o. oferă proprietatea care permite, 
identificarea controlului aflat sub mouse când s-a activat opțiunea din 
meniul contextual: 


if (contextMenul.SourceControl == textBox1) 
{ 
// contextMenul . Remove (menultem4) ; 
//. contextMenul .Menultems.Add (menulteml0) ; 
// MessageBox. Show 
// ("contex 
contextMenul .} 
} 


else if (contextMenul. 


{ 


t pentru textBoxi"); 
„Text= "Activat pentru textBoxl"; 


label1) 


MessageBox. Show ("contextMenul activat pentru label1"); 
// contextMenul1.MenuItems.Add (menuItemi3); 


) 

“După cum se vede din instrucţiunile puse în comentariu, este posibil 
să adaptăm dinamic opțiunile meniului în funcţie de controlul ţintă, 
adăugând sau eliminând unele opțiuni. Acest lucru face şi mai flexibilă 
utilizarea aceluiaşi meniu contextual, cu mici modificări funcționând 
pentru şi mai multe controale. 

De asemenea, controlul țintă poate fi identificat univoc printr-o 
construcţie de forma contextMenu1.sourcecontrol şi lui i se pot adresa 
direct diverse comenzi, ca în instrucțiunea de mai jos : l 


contextMenul.SourceControl.Text = "Activat pentru textBox1"; 


Cu aceasta generalizare, funcţiile de tratare a opţiunilor pentru . 
alegerea culorii de scriere, respectiv a fontului si, dimensiunii acestuia, ar... 
putea arăta astfel: 


rivate void menuItem8 Click 3 PE > 
(object sender, System.EventArgs e) 


ColorDialog colorDialogl =new ColorDialog(); 
if (colorDialogl.ShowDialog() == DialogResult.0OK) 
( : 


contextMenul. 
colorDialogl.Color; 
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SSCL ecru cu meniuri şi bare. | Lucrul cu meniuri şi bare ee nr ee 
bmp etc. 


private void menuItem7_Click 
i (object sender, System.EventArgs e) 


e cu toociBari selectat, Properties / Buttons Collection ( 33 ) + Add 
permite adăugarea de butoane în bara de instrumente; pentru fiecare 
buton se pot stabili proprietăţi ca: 

= nume, pentru identificare ulterioară 

=. stil ( Pushbutton, ToggleButton, Separator, DropDownButton) 

= textul de afişat: i 

a indexul imaginii de afişat ca icon, pe buton. 


{ 
FontDialog fontDialogl = new FontDialog(); 
if(fontDialog1.ShowDialog() == DialogResult.oK) 
po 
contextMenul. 


} 


contextMenul.SourceControl.Text="Nou"; 


„Font = fontDialogl.Font; 


) 


Evenimentele se pot pune numai pe ToolBar în ansamblu, 
particularizarea acțiunii făcându-se doar prin identificarea butonului care a 
generat evenimentul; identificarea se poate face după textul afişat pe buton, 
după numele butonului ( butoanele sunt “obiecte individuale de tip 
System. Windows.Forms.ToolBarButton recunoscute prin variabile şi la 
nivelul formei ), sau după poziţia pe care o ocupă în cadrul colecției de 
butoane (folosind operatorul de indexare {} ). 


private void toolBarl _ButtonClick 
© (object sender, ToolBarButtonClickEventArgs e) 


("\nS-a apasat butonul inscriptionat buti"); . 


// identificare dupa nume 
MessageBox. Show("|nS-a apasat butonul numit b2"); 
else pt fe. : Reng 


3. Controale de tip bara de instrumente — ToolBar 


ToolBar-urile sunt controale care sub forma unor bare constituite din 
butoane oferă posibilitatea . declanşării rapide a. unor acţiuni, frecvent 
folosite într-o aplicaţie. | 


// identificare dupa pozitie in. bara 
cb e ars 3 id d a apasat b4 de pe poz 3"); 


Lucrul cu ToolBar este relativ simplu: mC 
e se trage din ToolBox un control de tip ToolBar; el se meua automat MessageBox. Show ( "\nApasat"+-e.Button. Text); 
sub forma unei bare, sub bara de titlu sau sub meniul principal al E a ne 
l } : 


aplicației (docare Top), dar suportă şi celelalte tipuri de docări. 


int poz = toolBarl.Buttons.¥ (e.Button); 
// identificare pozitie 
e se aduce din ToolBox un ImageList Senin a putea folosi şi butoane cu 


icon-uri 


$ selectând 1istImage1 plasat sub formă, se denumeşte lista de imagini 
cu lst_img (Properties / Mame) se populează ( Froperties / Images 


De cele mai multe ori, butoanele unui ToolBar se asociază cu 
aceleaşi acțiuni executate si când selectăm opțiunile unui meniu. Să ne 
amintim câte din programele cu care lucrăm permit deschiderea, salvarea, 
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Collection + Add ) selectând cu browser-ul diverse fişiere de up ICO pie attic 


i Lucrul cu meniuri şi bare. 33 


copy sau paste, atât cu opțiuni din meniul File sau Edit, cât şi din butoanele 
cu icon-urile uşor de recunoscut ale unui toolbar. 

Pentru a nu scrie de două ori același cod sursă aferent acțiunilor de 
executat; codul este pus doar în funcția de tratare a evenimentului Click pe 
opțiune meniu. | 


Opţiunea respectivă este apoi declarată în proprietatea Tag a unui ` 


buton din ToolBar, asociind-o astfel butonului cu care are funcționalitate 
comparabilă. Spre exemplu, primul buton din toolBar afişează un icon de 
Open şi declanşează aceleaşi acțiuni ca opțiunea mnuFisierOpen : 


toolBar1.Buttons[9]. Tag = mnuFisierOpen; 


La click de mouse, butoanele nu tratează evenimentul, ci doar îl 
redirecționează către opțiunea de meniu asociată fiecăruia, şi-i cer să-l 
trateze simulând că s-a executat un click pe opţiune: 


private void toolBar1_ButtonClick 
E (object sender, ToolBarButtonClickEventArgs e) 
{ 

ToolBarButton tbarButton = e.Button; i 

MenuItem mnultem = (MenuItem) tbarButton.Tag; 
mnultem.PerformClick(); // metoda a optiunii de meniu 

) . - . 


Dezactivarea opțiunii din meniu. ( mnuFisieropen.Enabled = 
false;) inhibă posibilitatea declanşării acţiunilor asociate evenimentului 
Click pe meniu; dacă se doreşte şi inhibarea click-ului provenind din buton, 
acest lucru trebuie făcut însă distinct ( toolBarl.Enabled = false; sau 
punem cu designer-ul proprietatea pe false), pentru că inhibarea opțiunii 
de meniu nu inhibă automat şi butonul asociat. 


Alte observaţii: l 
e` butoanele pot fi redimensionate global, dacă la nivel de toolBar 


(nu de buton) declarăm alte dimensiuni pentru butoanele 
conţinute | 


e ca la toate controalele, o parte din proprietăți pot fi schimbate 
dinâmic | - 


Exercifiu 


Să se construiască un mini-editor grafic cu simboluri care scrie pe un 


panel, text introdus de la tastatură sau simboluri grafice asociate unor - 


butoane din toolbar ( ca în Word Equation ). 
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1. 


Rezolvare 


Inserare Panel ( folosit ca zonă pentru desen ) cu proprietăţile: 

. DrawGrid - false, Dock Bottom 

Font Arial, size 30; BackColor Red; 

mai multe butoane mici în colecția Buttons 


e 

inserare ToolBar, adăugăm 

a ToolBar-ului; l A 

creare bmp-uri ce vor fi afişate pe butoanele ToolBar-ului: 

e New / File / bmp 

e View / ToolBars / ImageEditor, dac 
pentru desen in bara de stare a mediului integrat 


e prelucram şi salvam imaginile, de fiecare dată sub alt nume: 
4 sugerând simbolurile 


ă nu vedem instrumentele 


alfa.bmp, beta.bmp, integr.bmp etc., 

desenate | 
e preferabil să punem un fond gri la desenarea imaginii, pentru 

asortare cu restul toolbar-ului; | | 
un obiect de tip list Image1 este adus din ToolBox şi populat cu bmp 


j i ja Images). 
uri (Properties / colecția 
Pe toolBar1 pus Properties în ListImage se alege listImagel, 
creată anterior; l 
asociem imagini fiecărui b 
aaa pentru fiecare, punan 
ListImagel; 


uton din toolBar1: Properties / Buttons şi 
d indexul imaginii corespunzătoare din 


~ 7. în Word, Insert / Symbol alegem font Symbol şi căutăm codurile 


afişate pentru simbolurile dorite. 


8. Declarare variabile de lucru, ca membri în formă: 
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public string txt; 
public PointF pnt; 
public Font []vfnt; 


// textul de Gesenat 
// poziţia de scriere 
// fonturi utilizate 


9. Initializare membri în constructorul formei: 


txt=""; pnt snew Point (10,10); 
vfnt= new Font [2]; 
vfnt[0]= new Font ("Arial",30); 
vfnt[1]= new Font ("Symbol", 30); 


10. Tratare Click pe ToolBar 


private void toolBarl_ButtonClick ( object sender, 


{ 
int i = toolBari 
txt+=(char)2; // 


char c=' +; 
switch(i) 
{ 
case 
case 
case 
case 
case 
case 
). 
txt+=c; 


ToolBarButtonClickEventargs e) 


OB WN BS 


panell.Invalidate (); 


) 


11. Funcţia de redesenare panel, la introducerea câte unui simbol din 


-Buttons. IndexOf (e.Button) ; 
va comuta font in simbol 


c='s'; break; 
c='a'; break; 
c='b'; break; 
c=(char)229; break; 
c= (char) 242; break; 
c=(char) 213; break; 


buton toolbar sau a unui caracter de la tastatură: 


{ . 
pnt.X=10; pnt.Y=10; 
Font fnt = vfnt[1];. 


private void panell_Paint (object sender, 


for(int i=0;i<txt.Length; i++) 


{ 


//textBoxl.Text+="\r\n"44 
// +((int)txt{i]).Tostring(); 


switch ((int)txt[i]) 


case 1: fnt=vfnt[0]; 
case 2: Ent=vfnt[1]; 


default: 
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-ToString()+" --- 


break; 
break; 


PaintEventArgs e) 


ucrul cu meniuri si bare 


{ . 
string. tmp=""+ txt [i]; 
„Graphics .DrawString 
E P tmp, fnt, new SolidBrush(Color.Red), 
i pnt.X,10 ); 


pnt.X+=fnt.Size; break; 
} 


12. Tratare introducere text de la tastatură 


jec der 
rio id Forml_KeyPress (object sender, 
ai date ab da KeyPressEventArgs e ) 


i txt+=(char)1; txt+= e.KeyChar; 


panell.Invalidate(); e.Handled=true; 


Punând proprietatea Dock pe None, putem apoi redimensiona ees 
ul astfel încât să afişeze butoanele pe mai multe rânduri, îl putem 
vizibil numai când apăsăm un buton din-alt toolbar “master g îl putem pla ; 
peste alt toolbar invizibil, astfel încât să devină vizibil în poziția în care s 


ne sugereze că este o dezvoltare a unui buton; spre exemplu, în figura de 


mai jos plasarea şi vizibilitatea toolbar-ului aferent simbolurilor „grecești 
sunt corelate cu butonul corespunzător din Toolbar-ul central de simboluri. 
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4. Controale de tip bară de stare - StatusBar 


Prezentăm în continuare câteva elemente de bază ce tin de lucru cu o 
bară de stare. 


e se aduce din ToolBox controlul StatusBar; el se numeşte statusBar1 
şi se plasează implicit pe formular, în partea de jos; 

e cu statusBari sel roperties / Panels permite: adăugarea de 
elemente la colecţia | ţinută de bara de stare; ne asigurăm că ele 
sunt şi vizibile ( statusBar1 are proprietatea ShowPanels pe true); 
vom adăuga patru astfel de panele. 


Afişarea orei exacte în ultimul panel din StatusBar 


e pe formă, se aduce din ToolBox un control de tip Timer, specializat în 
notificarea scurgerii unui interval de timp; el e plasat automat sub 
formular, nu va avea parte vizibilă la rulare, dar forma îl recunoaşte, iar 
prin program putem beneficia de serviciile lui. 


* cu timeri selectat, în Properties fixăm proprietatea Interval pe 
valoarea 1000 (adică la o secundă, deoarece intervalul de timp dorit se 
exprimă în milisec. ) i l : 


* cu timer1 selectat, în Properties fixim Enabled pe true, altfel ( adică 
rămânând pe false, deci inhibat ) obiectul Timer nu va semnala 
evenimentul tick, fiind candidat la ştergere prin garbage collector. 


e cu timeri selectat, in Properties + Events se tratează unicul 
eveniment, Tick, recunoscut de timer, adăugând codul: 


private void timeri_Tick ; 
(object sender, System.EventArgs e)’ 
{ . . 
statusBarl.Panels[3].Text = f 
DateTime.Now.ToLongTimeString(); 


ceea ce însemnă că la fiecare secundă se modifică textul înscris în 
ultimul panel din statusBar, prin afişarea orei exacte. 
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- Lucrul cu meniuri şi bare 


“gtatusBari selectat, Properties + Events 0 


„panelului pe care s-a da 


Sesizarea panelului pe care s-a dat click de mouse 


StatusBar recunoaşte printre evenimente şi Panelclick, Cu 
feră posibilitatea vizualizării 
evenimentelor recunoscute de acesta; dând click pe id e saii 
completând un nume de funcție şi dând Enter, putem adăuga co foe 
pentru acțiuni individualizabile la nivel de panel; pentru varietate, SESIZARE 

i t click se va face folosind o metodă aparținând 
primeşte ca- parametru panelul care a generat 


lectiilor (Indexof ) care ne 2 
a l du-ne poziția pe care acesta O are In 


evenimentul şi-l identifică, returnân 
colecție. 


vate void statusBari_Panelclick (object sender, 


pa StatusBarPanelClickEventArgs e) A 
ae i = statusBarl.1 ndexOf (e.StatusBarPanel) ; 
switch (i) 
{ 
case 3: 
bool activat = timer] .Enabled; a : 
bool stop = MessageBox. Show ("Opriti ceas?", 
"Stare timer “+ activat, MessageBoxBut tons. YesNo) 
== DialogResult.Yes; 
if( stop && activat ) f 
{ timeri.Enabled=faise; A 
statusBarl.Panels[3].Text=" a. 2 
break; 
case 1: ` , ae 
MessageBox. Show ("Ati apasat Panel 2. i break; 
Gefauit 


MessageBox. Show ("Ati apasat Panel "+(i+1)); break; 
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CONTROALE COMPLEXE DE VIZUALIZARE 


1. Vizualizare liniară - controlul ListView 
2. Vizualizare arborescentă — controlul TreeView 


1. Vizualizare liniară - controlul ListView 


Există câteva controale numite şi controale de vizualizare, deoarece ele 
oferă suportul pentru vizualizarea informaţiilor sub diverse formate: liniare, 
arborescente, rapoarte, liste de iconuri etc. Prin formatele sale de 
vizualizare, Details, LargeIcon, Smallicons sau List, controlul 
ListView este unul dintre cele mai des folosite. 


Mecanismul de lucru cu ListView 


1. Folosind Visual .NET se generează scheletul unei aplicaţii C# de tip 
Windows Forms. 

2. Se aduce prin drag & drop controlul ListView din ToolBox; pentru 
simplitate, denumim ( cu Properties / Name ) acest control 1v. 

3. Pentru că o listă de vizualizare foloseşte şi iconuri pentru reprezentarea 
simplificată a informaţiei, avem nevoie şi de un control Imagerist 
adus tot din ToolBox; mediul îl plasează pe linia de jos a machetei 
aplicaţiei; denumim această lista de imagini cu 14. 

4. Populare listei cu imagini: cu obiectul 141 selectat, folosind Properties / 
Images Collections “..." Aaa adăugăm imagini preluate din fişiere 
*.bmp. În capitolul despre controlul ToolBar se dau mai multe detalii 
privind crearea şi editarea imaginilor cu editorul specific mediului 
Visual Studio, dar aceste imagini pot fi construite şi cu editoare externe. 

5. Obiectul listă de imagini construit mai sus trebuie asociat cu controlul 
de vizualizare; în acest scop, ListView în Properties conține şi 
proprietăţile Large Image List, respectiv Small Image List; ele vor 
fi legate de lista creată mai sus, alegând din combo lista de imagini 14. 

6. Proprietatea View a obiectului 1v stabileşte formatul de vizualizare al 
listei (Details, LargeIcon, SmallIcons Sau List). 

7. Configurare iniţială a coloanelor (capul de tabel ) 

e lv / Properties / Columns / Collections (...) + Add; apelăm add 
repetat, pentru câte coloane adăugăm în listă; pentru fiecare membru 
adăugat stabilim totodată şi textul de afișat ( proprietatea Text) ; 
numele coloanei. (column header) putem să-l lăsăm cum îl generează 
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9. 


{ 


) 


{ 


8. Popularea statică ( la momentul proiectări ap 
vizualizare: 


automat 
sugestiv. 
Observaţie. Pentru a pu 
configurarii lor statice, lv tre 
(proprietatea view ) pus in prealabil pe Details. 


sistemul sau putem să-l modificam pentru a-l face mal 


tea să şi vedem coloanele pe masura 
buie să aibă formatul de vizualizare 


licatiei) a listei de 


e ly / Properties / Items / Collections (...) + S P 
repetat, pentru câte linii adăugăm; pentru fiecare ne ea r 
stabilim totodată şi textul de afişat în prima coloană a ae 
proprietatea Text ) când formatul de vizualizare este Smee a 
este cel care se afişează şi în formatul List Şi sub imagini, C 
formatul de vizualizare este LargeIcons sau mal Lena: l 4 

e Iy / Properties / Items / Collections (...) ; pentru fiecare item p 


anterior, în partea dreapta proprietatea Data are cea 4 
Collections (...) care deschide o fereastra similara cu pea = a 
Items; cu Add punem cate subitem-uri_ dorim; subitem aoe 
coloanele fiecărei linii; O matrice este văzută deci ca o PA T if 
linii (items), iar fiecare linie este o colecție de coloane (su i di > 
e Observatie: primul subitem e pus automat şi coincide cu > 
modificare 3] modifică si pe cel din item, deci în mod obis 


trebuie lăsat aşa. l 7 i 
Populare dinamică ( la momentul execuției ) se poate face preluând 


datele dintr-o structură de date: 


struct date 


public int Marca; 
public string Nume; 
blic double salariu; 
ce date (int m, “string nm, double s) A 


puklic BIE 
( Marca=m; Nume=nm; Salariu=s; ). 


private void ptncompletari_Click 


(object sender, ` System.EventArgs e) 


‘Ly.Columns Add ("Oobs",20, aaa zontalAlignment. Right); 
; =new date[2]; 

eae (400, “Adamescu Ion", 5300000}; 
ys[i]=#new date (500, "Banica Paul", 6500000); 

iv. Items -Add("300"); i 

foreach (date x in vs) 
{ 
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ListViewItem itm = 
new ListViewItem(x.Marca.ToString(),1); 
itm.SubItems.Add(x.Nume) ; 
itm. SubItems.Add(x.Salariu.Tostring()); 
1v.Items.Adă (itm) ; 
} 
} 


10. Pe meniu View putem schimba formatul de vizualizare: 


private void menDetaliu_Click 
{object sender, System.EventArgs e) 


{ 
lv.View = View. Details; 
private void menSmallIcon_Click 
(object sender, System.EventArgs e) 


{ 
lv.View = View.Smallicon; 


ae 


11. La schimbare item selectat, putem schimba culoarea de scriere: 


private void iv_SelectedIndexChanged 
; (object sender, System.EventArgs e) 
foreach(.ListViewItem itm in 1v. Items) 
if (itm. Selected)itm.Forecolor = System. Drawing. Color.Rea; 
else itm.ForeColor = System. Drawing. Color.Blue; 
‘ 7 
) 


„5500000. 
-< 6500000: =: 


[500 ` Banica Paul: 
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12. Tratarea evenimentului DoubleClick: 


private void lv_DoubleClick 
(object sender, System.EventArgs e) 


{ 


MessageBox.Show("“lv are "+lv.Items.Count+" linii"); 


} 


13. Dacă obiectul 1v are proprietatea MultiSelect pe true, ni se va 
permite selectarea simultană a mai multor item-uri. Controlul tine şi o 
colecţie cu toate item-urile selectate la un moment dat, evenimentul 
„Itemactivate declanşându-se la momentul indicat prin proprietatea 
Activation: 

e ItemActivation.Standard, 
e ItemActivation.OneClick sau 
e ItemActivation.TwoClick; 
Putem specula acest eveniment ataşându-i: un handler care 
prelucrează unul sau toate item-urile colecţiei : 


private void lv_ItemActivate (object sender, EventArgs e) 


{ 
MessageBox. Show 
(“Activare: " + lv.SelectedItems[0].Text); 


} 
Activarea ItemActivation.TwoClick; diferă de cea standard pe 


DoubleClick, pentru că cele două click-uri se pot da acum la orice 

‘interval de timp unul după altul, situaţie marcată şi prin schimbarea 
cursorului ( devine de tip "hand" ). Formele de activare oneclick: şi 
TwoClick dezactivează şi proprietatea Labelgăit, care va trebui cerută 
explicit acum. ee | m 


14. Salvarea item-urilor prin serializare într-un fișier: 


rivate void btnSalv_Click | 7 oe 
(object sender, System.EventArgs e) 


FileStream s = new FileStream("pers.dat",FileMode.Create) ; 
ArrayList lista = new ArrayList(); i 
foreach (ListViewItem itm in lv.Items) lista.Adă(itm); 


BinaryFormatter f = new BinaryFormatter(); 


f.Serialize(s, lista); 
s.Close(); 
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Deoarece colecția 1v.Items nu este serializabilă, declarăm o altă 
colecţie ArrayList lista, pe care după initializare o încărcăm cu item- 
urile din vizualizare. Un formater binar preia sarcina serializării noii 
colecţii. Se poate observa că în fişier sunt salvate obiecte complexe, cu toate 
informaţiile despre item (icon, stare etc.) 


lv.View = View. Details; // Vizualizare in format DETAILS 
lv.LabelEdit = true; // Editare direct in listView 


lv .AllowColumnReorder = true; // Aranjare coloane cu drag&d 


1 .CheckBoxes = true; // Atasare check box 

lv.FullRowSelect = true; // Select tot, nu doar primul item 
ly.Gridbines = true; // Grid de separare lin / col 
lv.Sorting = SortOrder.Ascending; // Tine items sortate asc 


15. Restaurarea listei prin deserializare din fisier 


private void btnRest_Click(cbject sender, System.EventArgs e) 
{ 
FileStream s = new FileStream("pers.dat",FileMode.Open) ; 
BinaryFormatter f = new BinaryFormatter(); 
ArrayList lista = (ArrayList) f.Deserialize(s); 
s.Close({); 
for(int i=0; i< lista.Count; i++) 


{ 


cap de lista 
aa ed O -2, HorizontalAlignment.Left); 
1v.Columns . Add ("Nume prenume",-2, HorizontalAlignment.Left); 
1v.Columns . Add ( "Salariu", -2, Hori zontalalignment. Right) ; 
jy. Columns . Add ( "Observatii", -2, HorizontalAlignment . Center) ; 


ListViewItem itm; 
itm= (ListViewItem) lista[i]; 
lv. Items .Add (itm); 


// Alocare şi încărcare trei item-uri cu persoane 
ListViewItem itemi = new ListViewltem("300",0); 
i tem] .Checked = true; 
i teml . Subltems.Adă ("Popescu Ion"); 
iteml.SubItems.Add("850"); 
iteml. SubI tems .Add("Transferat"); 
ListViewItem item2 = new ListViewItem("200",1); 
item2.SubItems .Add("Ionescu Vasile "); 
i tem2 . Subltems.Add ("950"); 
item2.SubItems.Add(""); 
ListViewItem item3 = new ListViewItem("100",0); 
item3.Checked = true; 
` item3. Subltems .Add ("Adamesteanu Ion"); 
i tem3 . Subltems.Add ("1250"); 
item3.SubItems.Add(""); 


>a 
Abordarea programatică a controlului ListView 


Aplicația de mai sus, construită în mare parte vizual, putea fi realizată 
şi scriind doar cod sursă C#. Iată cum ar arăta aceeaşi aplicație scriind o 
funcție care instanțiază obiectul ListView, îl configurează şi-l populează cu 
aceleaşi categorii de informaţii. În plus, se construiesc şi populează tot prin 
program şi cele.doua liste de me asociate item-urilor din lista de 
vizualizare. 

Listei de vizualizare i se e stabilesc ŞI câteva proprietăți mai deosebite: 

e să permită modificarea conținutului item-ului chiar în listă 

(LabelEdit); , 


e să afişeze item-urile cu un ClISCEDOX şi sortate crescător, indiferent 
de ordinea în care le adăugăm noi; 

e selecția unui item să producă selecția întregului rând din listă; 

e . conţinutul listei să fie afişat într-un grid; | 

e coloanele să poată fi reordonate cu drag ànd drop. 


// Populare lista prin adaugarea item-urilor la ListView 
lv.iItems. AddRange (new ListViewItem{] {item1, item2, item3)); 


// Creare liste de imagini asociate. 
ImageList -imagMici = new ImageList();.: 
ImageList imagMari = new ImageList()i,.... 


'// Populare liste cu imagini din fisiere 
jmagMici.Images.Add(Bitmap. FromFile("C:\\BELL.bmp") ) ; 
imagMici . Images. Add (Bitmap.FromFile ("C:\\PHONE. bmp")); 


imagMici.Images.Add(Bitmap. FromFile("C:\\CALENDAR. bmp") ); 
private void CreazaListView() 


{ 
ListView lv = new ListView(); 
lv.Bounds = 


new Rectangle(new Point(10,10), new Size(300,100)); 
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i nagMari . Images. Add (Bitmap. FromFile("C:\\HAND.bmp") ) ; 
imagMari . Images Add (Bitmap.FromFile ("C: VA FISH.bmp")); 


// Leaga listele cu imagini de listview 
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lv.LargeImageList = imagMari; 
lv.SmallImageList = imagMici; ` 


// Adauga ListView la colectia de controale a formei 
this.Controls.Add(lv); 


Functia de mai sus poate fi pusă ca funcție de tratare a unei opţiuni de 
meniu sau a evenimentului click de buton. spa 


iale void btnCreaza (object sender, System.EventArgs e) 
. CreazaListView(); 
-} 


2. Vizualizare arborescentă — controlul TreeView 


l Controlul TreeView este folosit pentru a afişa o colecție de 
informații in „formă . arborescentă, cu posibilitatea expandării sau 
„comprimării unor nivele din arbore. 

l Fiecare nod al controlului Treeview este un obiect de tip TreeNode 
Fiecare obiect TreeNode stochează în proprietatea Nodes 0 colecţie 
(TreeNodecollection) de subnoduri. corespunzătoare unui nivel ‘al 
arborelui. Proprietatea Nodes a controlului TreeView păstrează colecția de 
noduri aflată la primul nivel (nivelul 0) în arbore. Dacă există noduri pe 
nivelul 1 al arborelui, acestea vor fi stocate folosind proprietățile Nodes le 
nodurilor situate pe nivelul 0, ş.a.m.d. i i 
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+ Principalele proprietăți ale controlului TreeView: 


Nodes (get) — conține colecția de obiecte TreeNode asociată 
controlului sau asociată unui nod de pe nivelurile inferioare; 
PathSeparator (set / get) — conține delimitatorul folosit pentru calea 
nodurilor arborelui; 
Labelgăit (set / get) — indică dacă etichetele nodurilor pot fi editate 
saunu; . l Tad i 
SelectedNode (set / get) — specifică nodul curent selectat al arborelui; 
sorted (set / get) — indică daca nodurile sunt sau nu ordonate alfabetic; 
CheckBoxes (set / get) — stabileşte dacă fiecare nod al controlului va fi 
precedat sau nu de câte un check box, -` i 
ImageList (set / get) — precizează controlul de tip ImageList care 
conţine icon-urile asociate nodurilor. 


Principalele evenimente: 


“afterselect — este évenimentul implicit al clasei TreeView; se 
declanşează imediat după selectarea unui nod; 

AfterLabelEdit — este semnalat imediat după editarea etichetei unui 

nod; a Sit aa ok 

AfterExpand — apare imediat dupa expandarea unui nod. 


Mecanismul de lucru cu TreeView 


1. În Visual Studio se alege o aplicație C#, tip Windows Application 
2. Aducem un control TreeView din ToolBox şi îl denumim tv 
3. Adăugare de noduri statice se poate face cu: 

e Properties: colecţia Nodes şi activez Bue 

e buton AddRoot şi stabilim textul de afişat în nodul rădăcină; 


e buton Addchila daca dezvoltăm un nod existent. 


4. Adăugarea ‘de noduri la momentul execuţiei se poate face după 
modelul următor: l paT 
e în formă se definește o referință de nod, nodselect, pentru a tine 


nodul curent selectat la un moment dat, de care vom lega noul nod: 
TreeNode nodSelect; ; š 


e pe evenimentul AfterSelect Se încarcă referința pe măsură ce ne 
deplasăm prin arbore, preluând nodul din parametrul funcţiei de 


tratare: 
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nodSelect = e.Node; 


e pe opțiune meniu sau pe alt eveniment, se adaugă la colecția Nodes 
a nodului selectat, un nod nou, furnizând minimul de informaţie şi 
“anume eticheta nodului (preluând-o eventual dintr-un TextBox) 
după care se cere expandarea nodului curent, sau a întregului 
arbore: 


nodSelect .Nodes .Add ("Nod Nou"); 
nodselect Expand () ; 


Cele două operaţii principalele, inserare si stergere, pot fi realizate cu 
funcţii de genul celor care urmează: 


. Inserarea unui nod rădăcină în controlul treeViewi, existent la 
nivelul formei. : 


public Forml() 
{ ‘ 

InitializeComponent (); f 
//se creaza un obiect de tip TreeNode cu eticheta 
//"nodul 1", nod care se va adauga la controlul 
//TreeView ca nod radacina : 
TreeNode nodNou= new TreeNode ("nodul radacina" ); 
// se adauga nodul creat la controlul TreeView, 
treeViewl. Nodes. Add (nodNou) ; 


e. inserarea unui nod copil la nodul curent selectat: dacă nu există nici un’ 
nod selectat, noul nod se Sane tot la nivelul radacină: 


i : : ; E e, 


priváte void Insereaza (object sender, EventArgs. e) 

// se preia nodul selectat 

TreeNode nodCrt=treeViewl. SelectedNode; 

// se preia numarul nodurilor controlului Trée View 

int nr = treeViewl. GetNodeCount (true) +i; 

// se creaza un nod nou cu eticheta "nodul nn" 

TreeNode nodNou = new TreeNode ("nodul ."+nr); 

// daca nu exista nici un nod selectat 

if (nodCrt == null) 
// se adauga noul noâ. lângă celelalte noduri radacina 
Seas) cent Nodes Ada(nodNou); 

else 
// noul nod se adauga la colectia nodului selectat 
nodert .Nodes. Add (noâNou) ; 

treeViewl.ExpandAll () ; 

} 
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e  Stergerea unui nod din controlul TreeView şi a tuturor nodurilor 
copil ale acestuia: 


private void Stergere (object sender, System.EventArgs e) 


{ 


if (treeViewl.Nodes.Count>0) //daca exista noduri in arbore 
hide preia fn tn nodul selectat 
TreeNode tn = treeViewl.SelectedNode;: 
//daca nodul selectat nu este ultimul. se retin legaturile 
if (treeViewl.SelectedNode. NextNode!=null) 
//se retine nodul ce succeede nodului curent 
tn = treeView. SelectedNode.NextNode; 
else 
// daca nodul selectat nu este primul nod al arb. 
if (treeViewl.SelectedNode. PrevNode!=null) 
//se retine nodul ce precede nodului curent 
tn = treeViewl.SelectedNode. PrevNode; 
//se sterge nodul selectat 
treeViewl.SelectedNode. Remove () ; 
// nodul retinut in tn devine noul nod selectat 
ttreeViewl.SelectedNode. = tn; 
} . te, 6 Bod ee zS 


Proprietatea Dock se alege Fill dacă dorim să umple î întreaga formă. 


-- Atribuirea de i imagini fiecărui nod se face după modelul lucrului c cu a liste de 


imagini. 
Exercitiu 


Să se construiască . o. aplicaţie care să permită “` manipularea 
informaţiilor despre structura unor produse; pentru fiecare produs se cunosc 
denumirea şi cantitatea produsă, despre fiecare reper care intră în componența” 
produsului, denumirea şi nr.de repere/produs, iar pentru fiecare materie 
primă utilizată pentru realizarea reperului, denumirea şi consumul specific. 

Toate perechile de informaţii sunt prezentate în formatul 
denumire:cantitate. Construirea arborelui se va face dinamic, prin inserarea - 
de noduri. Inserarea, respectiv ştergerea nodurilor se realizeză folosind un 
meniu contextual. Editarea etichetelor nodurilor se face dând click pe aceasta. 
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Camion] : 
3 Caroserie: 
3. Metal:101 
Și: Vopsea 15 
InstalatieElectica: 1 
: Becuri: 21. 
Cabluri: 30°. 


F Conectori 17. k i 5 m 


Rezolvare 

1. Se inserează un control de tip TreeView, preluând din ToolBox / 
Windows Forms / TreeView . 

2.. Se redenumeste controlul în tvctri. 

3, Proprietatea Layout / Dock a controlului, Treeview ia valoarea 

; Left. 

4. . Pentru ca etichetele. nodurilor controlului să poată fi editate la 
execuţie trebuie ca proprietatea Behavior / LabelEdit a 
controlului TreeView să ia valoarea True. 

5. Proprietatea controlului TreeView Behaviox/sorted ia valoarea 
True pentru a afișa nodurile sortate alfabetic. 

6. . Se inserează un control de tip Dragelise din ToolBox / Windows 

Forms /ImageList. 
7. Cu ImageList selectat, Properties / Appearance / Images se 


adaugă patru imagini corespunzătoare tipurilor de informaţii: 
produs, reper, material şi una pentru elementul selectat; în acest 
scop se foloseşte editorul de colecţii, ca în fereastra următoare: 
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System. Drawing. Bitmap: 
a [E System Drawing, tinap 


8. 


10. . 


Se construieşte meniul aplic 


atiei având opțiunile: 


° operati i 


at salvare date 
_ Restaurare date 
- Ieşire | aan 
Se construieste un meniul contextual avand opțiunile: 
- Inserare 
- Stergere 


Se asociază obiectul de tip ContextM 
TreeView: proprietatea Behaviour “i / 
contextMenul - 


enu la controlul de tip 
ContextMenu / 
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11. Se tratează opţiunea Inserare a context-meniului prin tratarea { cil act at iii 
evenimentului Misc/click al opțiunii Inserare (vezi cod sursă), cl cit casa e ala 

12. Se tratează opțiunea ştergere a context-meniului prin tratarea components.Dispose (); 
evenimentul Misc/c11ck pe opțiunea ştergere. ) 

13. Se tratează evenimentul atterLabelEdit pentru validarea datelor = } 


introduse la modificarea etichetei. base.Dispose( disposing ); 


Codul sursă, corespunzător celor discutate mai sus, este următorul: iregion Windows Form Designer generated code 


using System; 


H 


private void InitializeComponent () 
{ 


using System. Drawing; 

using System.Collections; this.components = new System.ComponentModel .Container (); 
using System.ComponentModel; System. Resources.ResourceManager resources = , 
using System. Windows .Forms; new System. Resources.ResourceManager (typeof (Form1)); 
using System.Data; this.tvCtrl = new System.Windows.Forms.TreeView(); 


new System.Windows.Forms.ContextMenu(); 
new System.Windows.Forms.MenulItem() ; 
new System.Windows.Forms.Menultem(); 


this.contextMenul = 
this.menInserare = 
this.menStergere = 
this.imageListli = ; 

new System.Windows.Forms.ImageList(this.components) ; 


// namespace-uri pentru IO cu formatari si pentru serializare 
using System.I0; 


using System. Runtime.Serialization.Formatters.Binary; 


namespace tree 


nrNivele=0; 


} 


protected override void Dispose( bool disposing ) 


{ 


if( disposing ) 
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this.tvCtrl. 
this.tvCtrl. 
new NodeLabelEditEventHandler(this.tvCtrl_AfterLabelEdit) ; 


// 


{ this.mainMenul = new System.Windows.Forms.MainMenu (); 
public class Forml System. Windows. Forms. Form this.menAlege = new. System. Windows. Forms .MenuItem() ; 
ce: ` this.menSalvare = new System.Windows.Forms.MenulItem(); 
private System.Windows . Forms . TreeView tvctrl; this.menRestaurare = new System.Windows.Forms.Menultem(); 
rivate System. ComponentModel . IContainer components; this.menuItem4 = new System.Windows.Forms.MenuItem(); 
private System.Windows.Forms.MainMenu mainMenu1; this.menIesire = new System.Windows.Forms.Menultem() ; 
private System: Windows. Forms .MenuItem menAlege; this.SuspendLayout (); 
private System.Windows.Forms.MenuItem menSalvare; JI 
private System.Windows.Forms.Menultem menRestaurare; // tvCtrl 
private System.Windows.Forms.MenuItem menultem4; /1 
private System. Windows .Forms .MenuItem menlesire; this.tvCtrl.ContextMenu = this.contextMenul; 
private System.Windows.Forms.Menultem menInserare; this.tvCtrl.Dock = System.Windows.Forms.DockStyle.Left; 
private System.Windows.Forms.MenuItem menStergetre; this.tvCtrl.HideSelection = false; . 
private System.Windows:Forms.ImageList imageListi; this.tvCtrl.ImageList = this.imageListl; 
private System.Windows.Forms.ContextMenu contextMenul; this.tvCtrl.LabelEdit = true; Pi - E eră 
‘private int nrNivele; this.tvCtrl.Location = new System.Drawing.Point(0, 0); 
; - f this.tvCtrl.Name = "tvCtrl"; 
private static ArrayList lista; this.tvCtrl.RightToLeft = 
= | System.Windows.Forms.RightToLeft.No; 
public Formi() this.tvCtrl.SelectedImageIndex = 1; Poy a 77 
{ - this. tvCtrl.Size = new System.Drawing.Size(376, 273); 
InitializeComponent () ; this.tvCtrl.Sorted = true; 


Tablndex = 0; 
AfterLabelEdit += 


// contextMenul 


// 
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i: Controale complexe de vizualizare 


this.menSalvare.Click += 


tkis ContextMenul-. Menul tems. AddRange ( eean . 
new System. EventHandler (this.Salvare) ; 


new System.Windows.Forms .Menultem[] 


{ this.menlnserare, this.menStergere) ); // 
/f- // menRestaurare 
// menInserare . // 
if this.menRestaurare.Index = 1; 
this.menInserare.Index = 0; this.menRestaurare.Text = "Restaurare date"; 
this,menInserare.Text = "Inserare"; this.menRestaurare.Click += 
this.menInserare.Click += R new System. EventHandler (this.Restaurare) ; 
new System.EventHandler (this.Inserare) ; MI 
Jf // menuItem4 
// menStergere // 
ef this.menultem4. Index = 2; 
this.menStergere.Index = 1; this.menultem4. Text = "-"; 
this.menStergere.Text = "Stergere"; // j 
this.menStergere.Click += // menlesire : 
new System.EventHandler (this.Stergere) ; /f 
HI this.menlesire.Index = 3; 
// imageList1 this.menlesire.Text = "Iesire"; 
if this.menlesire.Click += 
this.imageListl.ImageSize = new System.Drawing.Size(16, 16); new System. EventHandler(this.Iesire); 
this.imageList1l.ImageStream = // i 
( (System. Windows . Forms . ImageListStreamer) : // Formi 
// 


(resources .GetObject ("imageListl.ImageStream"))); 
this.imageListi.TransparentColor = 
System. Drawing. Color. Transparent; 


this. AutoScaleBaseSize = new System. Drawing.Size (5, 13); 
this.ClientSize = new System. Drawing.Size (304, 273); 
this.Controls.Add(this.tvCtrl); 


A ae 

// mainMenul this.Menu = this.mainMenul; 

co this.Name = "Form1"; 
this.mainMenul .Menultems .AddRange ( this.Text = "Form1"; 

new System.Windows :Forms.Menultem[] this.ResumeLayout (false); 

{ this.menAlege} ); } 

// > #endregion 

// menAlege 

{1 [STAThread] 
this.menAlege.Index = 0; static void Main() 
"this.menAlege .Menultems .AddRange ( { 


new System.Windows , Forms.MenuItem[] Application. Run (new Form] ()); 


{ ) 
this.menSalvare, | 
„this.menRestaurare, private void Inserare (object sender, System.EventArgs e) 
this.menultem4, 1> ; 
this.menlesire TreeNode nodNou = new TreeNode(":"); 
) J // obiect nou de tip TreeNode cu eticheta ":" 
this.menAlege. Text = "Operatii"; nodNou.ImageIndex = 0; 
if if (tvctr1.Nodes.Count==0 | tvCtrl.SelectedNode==null) 
// menSalvare // nu exista nod in arbore sau nu este selectat nici un nod 
il tvCtrl .Nodes.Add(nodNou) ; //noul nod se adauga pe radacina 
this.menSalvare.Index = 0; if (tvCtrl.SelectedNode!=null) 
this.menSalvare.Text = “Salvare date"; //daca exista un nod selectat in TreeView 
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) 


{ A t 
TreeNode nodSel=tvCtrl.SelectedNode; 
//se preia in nodSel nodul selectat din TreeView 
nrNivele++; ; 
if(nrNivele>3) 

nrNivele=0; 
nodNou. ImageIndex=nrNivele; 
nodSel.Nodes.Add(nodNou); // adaugare la colectie 
) : 
tvCtrl.SelectedNode = nodNou; 
tvCtrl.ExpandAll (); 
tvCtrl.Sorted=true; 
nodNou.BeginEdit(); 


//nodul adaugat devine selectat 
//se expandeaza nodurile TreeView-wiui 


//se initiaza editarea etichetei 


private void Stergere(object sender, System.EventArgs e) 
{ 


} 


LE (tvCtrl.Nodes.Count>0) 
{ 


//daca exista noduri in arbore 


//se pastreaza nodul selectat in variabila tn 
TreeNode tn=tvCtrl1.SelectedNode; 
//daca noâul curent selectat nu e ultimul 
if (tvCtrl.SelectedNode.NextNode!=null) 
//se retine nodul ce succeede nodului curent 
tn=tvCtrl .SelectedNode.NextNode; 
else 
// daca nodul selectat nu este primul nod 
if (tvCtrl.SelectedNode. PrevNode!=nuli) 
//se retine nodul ce precede nodul curent 
tn=tvCtrl.SelectedNode. PrevNode; 
//se sterge nodul selectat 
tvCtrl.SelectedNode. Remove (); 
// tn devine noul crt selectat 
tvCtrl.SelectedNode = tn; 


private void Salvare (object. sender, System.EventArgs e) 
{ 


lista=new ArrayList();//lista pentru serializare 
foreach (TreeNode tn in tvCtrl.Nodes) - 
//transfer noduri din colectie in lista 
{ | : La 

-SalvareNod (tn, lista); //add nod in lista 

) 

"// serializare lista in fisierul "date.tree" 
FileStream s = i 

new FileStream("date.tree",FileMode.Create); 
BinaryFormatter f = i 
new BinaryFormatter(); 
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{ £.Serialize(s, lista) ;} 
ae (system. Runtime. Serialization. SerializationException) 


(MessageBox. Show ("Serializare esuata“);) 


s.Close(); 


} 
private void SalvareNod(TreeNode tn, ArrayList lista) 
{ 3 
j = it(':'); 
tring[] val=tn.Text.Spli 
a extragere subsiruri, folosind ':' ca separator 
// pentru a obtine denumirea, respectiv cantitatea 
ista.AGd( new E 
dili “ nod (val [0], Convert. Tolnt32 (val [1)), -> 
tn.FullPath, tn. ImageIndex) ); 
// adaugare informatii in lista, preluand din nod 
ach (TreeNode n in tn.Nodes) l l 
paa fiecare TreeNode din colectia nodului curent 


salvareNod (n, lista); l 
//apel recursiv, pentru salvarea tuturor nodurilor 


) 
ata void Restaurare (object sender, System.EventArgs e) 
í A a 
rest (tvCtrl, "date.tree 3 
//restaurare din fisierul "date.tree" 
} 


public static void rest (TreeView tvCtrl, string fis) 


{ poe A : 
if (File.Exists(fis)) 
i List 
// deserializare pentru transfer in Array: 


FileStream s = new FileStream(fis,FileMode.Open) ; 


BinaryFormatter £ = new BinaryFormatter () ; 


miau 


try l n 
{ FE ie T 
lista =(ArrayList) f.Deserialize(s); 

) £ R 4 ik | Sns 
catch PE E e se : a i 
(System.Ru time. Serialization. SerializationExceptio 

: + $ 3 l t i wy. 
căi MessageBox. Show("Deserializare esuata. !!"); 
return;. i é : 
} 
s.Close(); 


for (int i=0;i<lista.Count; i++) 
/fpentru fiecare element al listei 
{ 


nod inf =(nod) lista[il]; 
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TreeNode nodCurent= ; 
“new TreeNode (inf.val_den+":"+inf.val_cant); 
// se creaza un TresNode cu Text avand valoarea 
_//  denumire:cantitate 
string cn=Convert.ToString(inf.val_cale); 
stringl] parti = 
cn.Split(tvCtrl.PathSeparator.ToCharArray()); 
// subsirurile existente in numele caii nodului curent 
// se salveaza in variabila parti ` 
// se foloseste ca separator al sirurilor separatorul 
// controlului TreeView - proprietatea PathSeparator 
if (parti .Length>1) 
// daca exista doua parti, nodul nu este radacina 
4 . 
TreeNodeCollection nodes =tvCtrl.Nodes; 
// se extrage colectia de noduri a controlului 
TreeNode nodParinte = null; 
CautaNod(parti, ref nodParinte, nodes); 
// se cauta parintele nodului curent 
if (noaParinte != null) 
//daca nodul curent ara parinte 
{ 
nodParinte.Nodes.Add(nodCurent); 
// adaugare la parintele gasit 
} 5. 
} 
else tvCtrl.Nodes.Adâ(nodCurent); 
// nodul curent este nod radacina 
// si trebuie adaugat in colectia de noduri a tvCtrl 


private static void CautaNod( string[{] parti, 
ref TreeNode nodParinte, TreeNodeCollection nodes ) 
{ i 
foreach (TreeNode n in nodes) 
// pentru fiecare nod din colectia de nođuri 
{ 
if E ROTIE E EEEE EA T A eG 
// daca proprietatea Text a nodului curent coincide 
// cu numele parintelui nodului curent 
nodParinte = n; //se modifica parintele 
CautaNod (parti, ref nodParinte, n.Nodes); . 
// apel recursiv pt cautare in colectia de noduri a 
// nodului curent 


} 
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private void Iesire(object sender, System.EventArgs e) 


{ 
Application.Exit(); 


private void tvCtrl_AfterLabelEdit (object sender, 
system. Windows. E Forms. NodeLabelEditEventargs e) 


(i 
string [] etNoua; 
// validare format general (denumire:cantitate) 


try{etNoua=e.Label. Split(':');} 
/{proprietatea Label contine noul text asociat TreeNod-ului 
//daca nu exista ':' in noul text al TreeNod-ului 
catch (System. Exception) 

{ 


e.CancelEdit=true; //se suspenda modificarea textului 


return; 


} 


// daca nu s-a respectat formatul general 

// se anuleaza modificarea facuta 
if (etNoua.Length==0) (e. CancelEdit= true; return; } 
if (etNoua.Length= =2). : 

//textul noii etichete contine un singur caracter 


{ 


try{Convert. uses Ca ea ua LISS Jaan dă cae 
//se incearca convertirea la intreg a cantitatii 


catch (System. FormatException) 
{ //daca in urma conversiei: apare o eroare 


e.CancelEdit=true; 
//se anuleaza modificarea textului - 


Pentru serializarea datelor s-a folosit o clasă nod cu următorul cod sursă: 


using System; 
using System.Collections; 


namespace tree 


1 
[Serializable()] 
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a LUCRU CU FERESTRE MULTIPLE 


public class nod 
{ 
string den; // denumire prod, mat sau reper 
int cant; // cantitate prod, mat sau reper 
string cale; // calea nodului in cadrul structurii 


int idximg; // indexul listei de imaginii 
public noâ()() 


1. Ferestre secundare de dialog 
2. Aplicaţii de tip Multiple Document Interface - MDI 


public nod(string.d, int c, string vcale, int vidximg ) 


1. Ferestre secundare de dialog 
{den=d; cant=c; cale=vcale; idximg=vidximg;.} 


pe ae ene Dialog Box (caseta de dialog ) este tot un obiect de tip Form care, 


prin conventie, are următoarele particularităţi: 
get { return cant; } l iy. | | | | | 
set. { cant=value; } e proprietatea “FormBorderStyle este FixedDialog (nu: poate fi 
} 


“redimensionată la momentul rulării); 
public string val_den 


proprietăţile MaximizeBox $i MinimizeBox sunt puse pe False pentru a 
t + 


e i va 
get (return den;) preveni minimizarea său maximizarea ferestrei de dialog; aceste setări 
: iai tele i . . é i 
set {den=value;}.. elimina automat si butoanele Maximize $1 Minimize din meniul sistem 
) 


(colţul stânga-sus). Eventual se scot complet atât meniul sistem (colțul 
stânga sus a] ferestrei), cât şi controalele de minimizare/maximizare 


a ie a setând pe False proprietatea Control Box a formei; 


fo, SHE : a: 
i get (return cale;) 
` set {cale=value; } 


e detine cel putin două butoane, uzual inscripţionat OK $i Cancel, pentru 
} ee, 


închiderea dialogului, cu păstrarea sau nu a modificărilor efectuate prin 
Și intermediul dialogului şi receptionarea unui mesaj de răspuns. 
public int val_idxi z<>., , i a 

' | e Caseta de dialog: are şi două proprietăți AcceptButton și 
CancelButton, prin care se indică butoanele cu rol de ok, respectiv 
cancel, când butoanele sunt inscripționate altcumva. Totodată fixarea 
ay AE PEES i: og sge N ts. ae A . tin tastele 

= acestei proprietăți asigură posibilitatea terminării dialogului pr s 
“Enter sau Esc, Valoarea returnată corespunzând celor două butoane cu 
„care acestea sunt asociate, .. - 


get -= {return ' idximg; ¥- 
set {idximg=value; } 


Casetele de dialog sunt de două tipuri: modale şi nemodaie. — 


y Modal Dialog Box — caseta de dialog modală, nu permite părăsirea 
ferestrei pentru a accesa altă fereastră a aplicației, înainte de închiderea ei. 
Se. consideră că răspunsul este atât de important încât aplicația nu poate 
continua până nu se dă acest răspuns. 


După crearea formei folosind modelul convenţional, forma se activează 


cu 
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Modeless Dialog Box — caseta de dialog nemodală, permite părăsirea 
ei fără să o închizi; astfel se poate reveni ulterior în fereastră pentru a 
continua lucrul. Chiar când este inactivă, fereastra nemodală se afişează în 
fata aplicaţiei părinte, pentru a fi totuşi vizibilă până la închidere ( de 
exemplu, caseta Find / Replace într-un editor de text ). 

Spre deosebire de fereastra de dialog modală, după creare, fereastra de 
dialog nemodală se activează cu 4 


Mecanismul de lucru cu ferestre de dialog este simplu. . 

1. : Se adaugă o noua forma (Project / Add Windows Form / Windows 
Form / nume ) şi i se stabilesc proprietăţile unei ferestre de dialog. I 
se pun, două butoane ok şi Cancel cărora li se fixează proprietatea 
DialogResult pe una din valorile enumerării DialogResult (OK, 


Cancel, Abort, Retry, Ignore, Yes, $i No) corespunzătoare 
fiecăruia, după rolul său. 


2. Pe forma părinte, legat de Click buton sau de opțiune meniu se 
instantiaza şi activează fereastra de dialog: 


private void buttonil_Click f 
(object sender, System.EventArgs e) 
{ . 
ig macheta ml = new macheta(); 
your ai mi ShowDialog()j oo 
` -4£(m1.DialogResult == DialogResult.OK) 
Camp.Text = ml .Camp. Text; 
else .. |. a i 
i a flCamp. Text = ""; 
yo i : 


Tot în 'acestă funcţie se tratează modul de terminare a dialogului, 
“decizând dacă se preiau (DialogResult.OK ) sau nu (celelalte posibile 
variante returnate Cancel, Abort, Retry,’ Ignore, Yes, şi:No) 
valorile introduse în diverse câmpuri, pe durata afişării dialogului. 


Se observă că această funcţie asigură vizibilitate simultană atât asupra 
câmpurilor din forma 1, cât şi a câmpurilor din forma 2. Cele din forma | 
sunt văzute implicit deoarece funcția de tratare aparţine acestei clase, iar 
cele din forma 2 se califică pe baza obiectului de tip forma 2 instantiat — 
aici şi care este vizibil în tot blocul de definire. 
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Aşadar, după închidere şi până la ieşirea din blocul funcţiei care a 
activat dialogul, obiectul dialog încă mai există şi pot fi preluate 
proprietăți ale acestuia. 


Butoanele puse pe forma 2 vor inchide automat forma ( nu trebuie dat 
explicit close () ), dacă au setată proprietatea DialogResult pe orice 
valoare din enumerare, exceptând None. Daer, | 

La închidere, proprietatea DialogResult a formei preia automat 

valoarea DialogResult a butonului care a închis dialogul, astfel A să 
ştim după dispariția imaginii dialogului ce buton a cauzat terminarea n si 
să reactionam în consecință. Mal mult decât atât, proprietatea 
pialogResult a formei nici măcar nu trebuie preluată, căci ea este returnată 
şi de funcţia de showDialog (} la închiderea dialogului. l 


Acum ne putem explica simplitatea lucrului cu controale de dialog de 
i tip Font Dialog, ColorDialog, OpenFileDialog, SaveFileDialog etc. 

Acestea deţin proprietăți specifice prin intermediul cărora se pot prelua 
la închiderea dialogului, informaţiile introduse sau alese pe durata derulării 
dialogului. 

ColorDialog prin selectarea culorii îşi setează propria sa proprietate 
color, pe care la întoarcere în apelant o putem prelua drept culoare pentru 
vreuna din proprietăţile unui control de pe forma principală: 


labeli.BackColor = colorDialog1.Color; 


Similar, FontDialog întoarce fontul selectat în propria sa proprietate 


Font: j ka 
labell.Font = fontDialog1.Font; 


OpenFileDialog are proprietatea FileName ce va fi încărcată cu 
numele fişierului selectat la vizualizarea controlului de tip dialog: 


OpenFileDialog openFileDialog2= new OpenFileDialog(); | 
openFileDialog2 „ShowDialog(); , 


Box.Show("Ati ales fisierul " +. Acra 
Message openFileDialog2. FileName) ; 


Exercitiu 


OpenFileDialog $l 


Exemplificați utilizarea controalelor alog `S 
; „ specializată în 


SaveFileDialog, construind O aplicație gen 
editarea, salvarea şi restaurarea unui text în / din fişier. 
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1. Pe o formă dimensionată corespunzător, se adaugă un TextBox 
numit editData; i se pune proprietatea Multiline pe True Şi Va fi 
docat Fi11, astfel încât să umple întreaga formă. 


2. Se adaugă în antet using System.I0; pentru recunoaşterea 
obiectelor de VO. 

3. Se aduce din ToolBox un meniu căruia i se adaugă pe Fisier 
opţiunile open, Save şi Close. 

4. Se declară un membru în clasa Forml public Stream fisier; 

5. Se tratează opțiunea open cu funcţia: 


private void menopen_Click (object sender, System.EventArgs e) 
{ 
OpenFileDialog openFileDialog2= new OpenFileDialog()j; 
if (openFileDialog2 .ShowDialog()==DialogResult .OK ) 
{ 
//MessageBox.Show("Ati ales fisierul " + 
// openFileDialog2.FileName) ; 
fisier = openFileDialog2.OpenFile(); 
StreamReader cititor = new StreamReader (fisier); 
//StreamReader cititor = i 
// new StreamReader("c:\\myfile.txt"); 


: string lin;int i=0; editData.Text=""; 
while((lin =cititor.ReadLine()) !=null) 
{ 
//nu: editData.Lines.SetValue(lin,i); 
//nu: editData.Lines[i].Insert(0,lin); 
editData.Text+=lin+"\r\n"; 
// !! ca sa poata adauga si in regim de 
//. editare cu Enter 
//nu: editData.Lines[i]=lin; 
) : : 


cititor.Close(); 


Respectând convenția, OpenFileDialog returnează ca orice dialog, 
proprietatea DialogResult. l ; 7 

Dacă pe durata afişării dialogului OpenFileDialog s-a selectat un 
fişier, iar la închidere s-a dat ox, se.poate deschide fişierul ales, folosind 
funcția openFile()a aceluiaşi dialog. De remarcat că dialogul în sine nu 
face decât selectarea unui fişier, nu îl şi deschide cum am putea crede după 
numele controlului. Controlul tine în schimb numele fişierului, astfel încât 
metoda sa openFileDialog2.openFile() să nu mai necesite parametri de 
intrare. 


146 


linie cu linie conținutul fişieru 


restre multi 


apoi un StreamReader, Cu Care se citeşte 
lui şi se adaugă TextB ox-ului. | 

face cu operatorul += la proprietatea Text 
“\r\n" textul va fi stocat in alt string al 


Fişierului i se ataşează 


Se observă că adăugarea se 
a controlului; la întâlnirea unui 


i ines. na” 
vectorului editData.L | | 
StreamReader şi StreamWriter sunt recomandati pentru fişiere 


despre a caror structură se ştie ceva (terminatorul de înregistrare este 
newline). 


6. Se tratează opţiunea save cu funcția: 


: 4 menSave_Click (object sender, System.EventArgs e) 


private ve: 
i SaveFileDialog saveFileDialog2= new SaveFileDialog(); 
if ( sayeFileDialog2 . ShowDialog()==DialogResult . OK) 
/ (MessageBox. Show ("Ati ales fisierul "4 
// saveFileDialog2.FileName) ; 
isi = /OpenFile() ; 
isier = saveFileDialog2 a | 
sistat ed scriitor = new StreamWriter (fisier): 
foreach( string lin in editData.Lines) | 
A scriitor.WriteLine (lin); 
scriitor.Close(); 
. ) 
) 


Dacă pe durata afişării dialogului SaveFileDialog s-a ag ze 
fişier iar la închidere s-a dat ok, se poate deschide fişierul ales folosin 
fuñctia openFile()a aceluiasi dialog; fişierului i se ataşează apoi un 
StreamWriter care ulterior preia toate liniile, din vectorul de string-uni 
editData-Lines al textBox-ului și le scrie in fişier. 

7. Se asociază evenimentului click pe opțiunea Close funcția: 

private void menClose_Click 


(object. sender, system. EventArgs e) 


i 


try C fisier.Close();) 
catch { } 
editData.Text=""; 

} 


Prin try functia mascheaza eventuala tentativă de închidere a unui 
fişier deja închis. De observat că dacă la save nu se dă ox fişierul rămâne 


deschis. 
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Lucru cu ferestre multi le „+ 


Clasa FileInfo ataşată unui fi 
permite extragerea selectivă a unor info 
etc. > 


şier returnat de openFi1eDialog îi 
rmaţii despre fişier: numele, extensia Ele se bazează pe ideea că datele sunt de obicei stocate în clase 
« document » specializate şi că o aplicaţie poate lucra cu unul sau mai 
multe documente. Scopul arhitecturii: este de a permite utilizatorului 
să lucreze simultan cu mai multe documente fără să lanseze o nouă 
instanță a aplicației, ci doar să deschidă o nouă fereastră în cadrul 
aceleeaşi aplicații. 


Vom deosebi în acest caz o formă (sau fereastră ) cadru principală 
sau părinte, cu meniu propriu şi o formă ( sau fereastră ) cadru 
secundară sau copil, ce poate fi instanţiată în mai multe exemplare, 
câte unul pentru fiecare document deschis la un moment dat. Forma 
„secundară poate avea sau nu propriul meniu, sau poate mixa opţiuni cu 
cele din meniul formei-principale. i 


jtestari.esproj +. 
A testări. csproj.user. . 


Legătura dintre cele două tipuri de ferestre se manifestă şi vizual, în 
sensul că formele care au părinte pot fi afișate numai în interiorul 
ferestrei părinte. ` 


Mecanismul este destul de simplu: obiectele Form au două proprietăți 

= IsMdicontainer, care pusă pe true anunță că forma este o 
fereastră principală ce poate ține ferestrele altor forme; secundare. 

"  Mdiparent care pentru o formă secundară tine referința formei 
părinte. i 


- Geen ca exercițiu completarea aplicaţiei cu butoane pe un ToolBar 
ca alternativă pentru apelul funcțiilor de mai „sus, sau schimbarea 
proprietăților textului (font, dimensiune, culoare =: e een 

7 Tot ca exerciţiu, să se transforme apoi controlul într-un control de 
utilizator Edit Box şi să fie înscris în ToolBox. ` db, 


În acest fel formele pot fi legate unele de altele. 


private void menFferNoua_Click (object sender, EventArgs e) 
CA Pee chs rA R AA a. ÎI | 
Form2 f2= new Form2();, .. DI ee er 
£2.MdiParent = this; , Í 
£2. Show(); ae 
+ De reţinut că Form1 are setată vizual proprietatea I'sMdicontainer, in. 
-` timp ce forma secundară Form2 are setată proprietatea Maiparent prin 
cod, nefiind browsabilă. E na ie. 


i 


(2. Aplicaţii de tip Multiple Document Interface - MDI E 


Din punct de vedere al mulţimii datelor'eu care lucrează o aplicaţie i 
au desprins două arhitecturi, bine conturate în majoritatea biblioteci! ‘a 
clase utilizate în programarea orientată obiect: yen 
= arhitectura SDI — Single Document Interface 
"arhitectura MDI — Multiple Document Interface 


În general, aplicaţiile MDI presupun stocarea datelor din:-documente in | 
fişiere şi respectiv încărcarea datelor din fişiere în documente, prin 
procedeul de serializare. Din acest motiv, exemplificarea o vom face în 
paralel cu lucru cu fişiere. 
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Exercitiu 


Să se construiască o aplicație MDI cu vizualizare tip formular, care va 
conţine la rândul ei mai multe ferestre copil ce permit preluarea dintr-o 
machetă de introducere date a unor informaţii despre materiale. 


articol. 
Rezolvare 
1. Se coristruieşte un proiect Visual C# cu aplicație Windows 
Application; i | li 
2. Fereastra cadru principală a aplicaţiei trebuie să fie container pentru 
ferestrele copil: proprietatea IsmaiContainer a formei se-setează 
pe true; 
3, Se adaugă un meniu ferestrei cadru principale a aplicației, pentru - 


Aplicația asigură şi serializarea / deserializarea datelor la nivel de 


manipularea ferestrelor copil, având opțiunile: ise 
e Fişler ae S 
— Fereastră nouă 
— Închide toate ferestrele 
„„— Ieşire ză | l a p 
> AranJare ferestre woo lass, oie pe : 
=" fn cascada 


=  Orizontal 
=s Verticar. -, bs ot ae 


În acest scop se aduce din Toolbox un control MainMenu si i se 


stabilesc opţiunile de mai sus. Se asociază: apoi meniul cu fereastra 
principală: proprietatea Menu a formei principale (Form1) . ia valoarea 
mainMenul. es ; 

4.. Se crează şablonul fereastrei cadru copil —fereastra de interacțiune cu 


„ documentul . aplicaţiei, inserând o. formă nouă: Project /. Add 


Windows Form / Windows Form ŞI i se dă un nume. . 

Se adaugă ferestrei copil un meniu cu opțiuni care tin de 
manipularea datelor: Date cu subopțiunile-Incazcă Şi Salvează. 
Pe suboptiunea Fereastră nouă a meniului ferestrei principale, se 
instanțiază o nouă fereastră copil: 


//se creaza o noua instanta a formei copil 
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//foxma copil se aduce i i 
fcopil.ClientSize = this.ClientSize; 


NIC++; 


foopil.Text="Copilul nr f 
fcopil.Show() ; '".-//se afiseaza forma copil 


meniului Aranjare, e | 
părinte şi membrii  enumerației  MăiLayout:  Arrahgelcons, 


Cascade, TileHorizontal, Tilevertical. 
Pe opţiunea orizontal a meniului Aranjare ferestre, VOM scrie: 


w Form2(); l 
//se stabileste parintele 


mensiunile formei parinte 


//nrc - numărul formelor copil create; i 
// initializat cu 0 în constructorul formei 1 


a + nre; // titlul formei copil 


7. Pentru aranjarea ferestrelor copil, în funcție de opțiunea selectată a 


se foloseşte metoda LayoutMdi a formei 


this.LayoutMdi (MdiLayout. TileHorizontal); 


Se procedează similar. ; pentru celelalte opțiuni de aranjare a 


ferestrelor. ag 
8. Cele trei optiuni principale ale meniului compus sunt: Fişier, 
Date. Dar în aplicațiile Windows este 
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Lucru cu ferestre multiple 


; Lucru cu ferestre multiple 


obişnuită poziționarea meniului Aranjare ferestre- la urmă, 
Pentru a schimba ordinea: proprietatea MergeOrder a opțiunii Date 
a meniului i se schimbă valoarea în 1, iar a opțiunii Aranjare 
ferestre în 2, opțiunea Fişier rămânând cu valoarea 0. 

9. Se adaugă, în forma cadru copil (Forma2), controale (Label $i 
TextBox) pentru introducerea de date pentru materiale: denumire, 
cantitate, pret unitar şi pentru afişarea valorii materialului 
(controlul de tip TextBox corespunzător are proprietatea Enabled pe 
valoare false). e 

“10. Se inserează în proiect o nouă clasă material: Project / Add Class 
/ Class / material, având variabilele private: den, cant, pret, 
val şi proprietățile accesabile prin get Şi set: val_den, -val_cant, 
val_pret,. val_val. : : 

11. Odată cu modificarea valorilor cant sau pret, în fereastra copil 
(evenimentul TextChanged), se modifică corespunzător şi valoarea. 


- se realizează salvarea datelor introduse în fereastra copil activă, într- 
un fişier de tip „mat, astfel: 


val: 


double t=Convert . ToDouble (tb_pret. Text) * 
ae f Convert. Tolnt32 (tb_cant. Text) ; 
tbh_val.Text=Convert .ToString(t); - e i oi) 
12. Se defineşte și se instanţiază un obiect mat_meu de tip material: 
- {nclasa-Form2 se declară variabila: 
i private material mat_meu; 


- . iar în constructorul Form2(): 
ii mat_meu = new material (); . : 


ni E ` 


13. Se pot salvà datele: obiectului mat_meu,.într-ün fişier, prin operația // conversiile datelor introduse în TextBox-uri, 

“de serializare. Serializarea permite unui obiect să fie convertit într- paai eae arene 
+ un flux de date, care apoi este salvat într-un fişier. Operația inversă, 

„de restaurare a datelor anterior salvate, se numeşte deserializare. l 


bes i 
a van 


mat_meu.val_den=tb_den.Text; | OBOE, 

mati meu.val.cant=Convert.ToInt16(tb_cant.Text) ; 
mat_meu.val_pret=Convert ToDouble (tb_pret. Text); 
mat_meu.val_val=Convert .ToDouble (tb val. Text); 


„> Salvarea datelor introduse în controale (serializarea) se realizează 
„astfel: : eer : ai 
- sé declară clasa material ca fiind serializabită, prin adăugarea 
înaintea definiției clasei a atributului: 


Ii aa dial numelui fişierului în care se vor salva 


SaveFileDialog fd = new SaveFileDialog(); 
fad.CheckPathExists=true; 3 
fa.Filter="fisiere mat .(*.mat)|*.mat"; 

if (fă. ShowDialog () ==DialogResult .OK) 

{ 


//se crează un Stream, folosit ca depozit de date 


- se adaugă cu using namespace-urile: 


System. IO; t S 
System. Runtime. Serialization. Formatters.Binary; 
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Stream myfs = File.Create(fd.FileName);. .. 
// se instantiaza un BinaryFormatter folosit 
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// pentru formatarea datelar, în acest caz un 
// : : „flux binar 
BinaryFormatter serializer = 
ae new BinaryFormatter () ; 
// obiectul este scris în flux 
serializer. Serialize (myfs, mat _meu); 
// se închide streamul pentru a finaliza serializarea 
myfs.Close(); l 
) 


În fişierul selectat / creat la salvare, există o instanță a obiectului 
mat_meu, în format binar.. ; y l : 


14. Operația inversă, de restaurare (deserializare) se execută după 
aceleaşi principii ca serializarea: 


// obiect OpenFileDialog pentru selectare fişier *:mat 

OpenFileDialog fd=new OpenFileDialog(); 

fd.CheckFileExists=true; 

fa.CheckPathExists=true; 

fd.Filter="fisiere mat (*.mat)|*.mat";. 

if (fd. ShowDialog()==DialogResult.OK) 

{ . | . 

// se crează un obiect de tip Stream şi se deschide 

// fişierul care conţine obiectul serializat 

Stream myfs= File.OpenRead (fd.FileName).; 

// se crează o instanţă a clasei folosită la 

// serializare pentru formatarea obiectului salvat 
sd i _ BinaryFormatter deser= new BinaryFormatter(); 
` // metoda Deserialize a obiectului folosit la 

// formatare reconverteşte fluxul de date într-un 

// obiect de tip material 


mat_meu= (material) (deser.Deserialize(myfs)) ; 
myfs.Close(); 
„.u-// se realizează conversia In, string pentru. a putea fi 
-.f// Sncearcate datele în TextBox-uri . 
„» „ „tb _den.Text = mat.meu.val_den; .. E 
tb_cant.Text=Convert.ToString (mat_meu.val_cant); 
«vian th.pret.Text=Convert.ToString (mat_meu.val_pret) ; 
tb_val.Text =Convert.ToString (mat_meu.val_ val); | 
) $ ae as > ` 7 ie a aie ee 
Pentru simplificare am presupus aici o- serializare la nivel de 
înregistrare; în mod curent înregistrările din machetă sunt preluate una câte 
una într-o colecţie ArrayList, care este la rândul ei serializată / 
- deserializată în întregime, dintr-un Singur apel serialize / Deserialize 
(a se vedea aplicaţia de serializare a unei facturi din subcapitolul 
Gestiunea unitară a controalelor unei forme ) . 
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SUPORTUL .NET PENTRU IMPRIMARE ȘI - 
PREVIZUALIZARE 


1. Clasa PrintDocument a l 
2. Previzualizarea documentului de imprimat 
3. Imprimarea documentelor utilizând generatorul de 


rapoarte CrystalReports 


Namespace-urile System.Drawing.Printing ŞI System.IO ae n 
definițiile pentru clasele si metodele de imprimare şi se dau de obicei su 
forma: n, J 
using System.Drawing; ai 
using System.Drawing.Printing; 
using System.I0; 


4 


f; Clasa PrintDocument 


Imprimanta este o locație care dispune de un obiect Graphics ce poate i 
folosit la scriere. Clasa PrintDocument gestioneaza procesul de imprimare; 
ea poate fi văzută ca 0 conexiune dintre aplicație şi imprimantă. l 

PrintDocument furnizează totodată un obiect reutilizabil ce transmite 


ieşirea la imprimantă; clasa conține şi metoda Print — pentru startarea 
procesului de imprimare. 


Evenimente sesizate: 


e * peginprint '— lansat” înaintea imprimării primei pagini din 

aocument . . wie . . pi E te . £ . 
+  Enăprint — declanşat la sfârşitul imprimării ultimei, pagini din 
* “document; 00 7 ety 


“e “print Page — activat la începutul fiecărei pagini; > 
o QueryPageSettings - länsat imediat înainte de printPage, pentru 
a stabili particularitatile de imprimare ale paginii curente. 


Schematic, mecanismul de imprimare este următorul: 


e aplicația deċlară un membru de clasă PrintDocument (sau aduce un 
control PrintDocument din ToolBox); 
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e legat de un buton sau de o opțiune meniu, „aplicaţia crează o instanță 
a clasei PrintDocument şi-i invocă metoda Print (); 

e apelul acestei metode produce evenimentul PrintPage; 

e acțiunea de desenare constă de fapt în ceea ce programatorul pune ca 
instrucțiuni în handler-ul de tratare a evenimentului PrintPage. De 
observat că handler-ul pentru PrintPage primeşte automat ca 
argument ` un obiect PrintPageEventargs, care dispune de 


proprietatea Graphics ce este’ o referință la cone grafic al 
imprimantei. 


Exemplu simplu. 


e Se aduc din ToolBox mainMenul, textBox1, printDocument1; 


e meniului i se pune opțiunea Imprima, tratată pe Click printr-o funcţie 
ce apelează printDocument1. Print (); 


e textBoxl.Text se stabileşte în POPE AS “Exempli ded text scris 
la imprimanta" 


e lui printDocument1 ise tratează Esential PrintPage cuo ~ 


funcție care conține: 


e.Graphics .Drawstring 
( textBoxi.Text, 
new Font ("Arial",12), 
“new SolidBrush (Color. Red) ; eo i 
printDocumentl1. DefaultPageSettings.Margins.Left, 
printDocument1. prea des ates Margins. TOP 
i 


o 


„ Trebuie să avem instalată o. imprimantă pentru a vedea că primește 
documentul. 


“Dacă se sua din ToolBox şi un Print PreviewDialog si 


adică pe controlul existent 
pe formă, putem eclansa pe Click opțiune Previzualizare din meniul 
Fişier, afişarea dialogului: 


“private void menultem3_Click 

(object sender, System. EventArgs e) 
{ i . . 
T printPreviewDialog1.ShowDialog(); 
) 5 
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documentului asociat acestuia, care la rândul ei produce evenimentul 
printPage, care este deja tratat, numai că ieşirea e reorientată acum spre 


ecran, nu spre imprimantă. 
Stabilirea proprietăților paginii şi imprimantei 


1. Dacă se doreşte şi modificarea setărilor de pagină şi / sau 
imprimantă înainte de imprimare, se vor adăuga la formă încă aoe 
controale specializate : pageSetupDialogi ŞI printDialogl. e 
meniul Fişier se adaugă opțiunile Pagesetup şi PrinterSetup. 

2. Se pune using System. Drawing.Printing; daca se era 
calificarea simplă a obiectelor şi metodelor din namespace- -ul cuprinzan 


functiile de imprimare. 


3. Se scrie handler-ul de tratare a opțiunii PageSetup ( se presupune că am 
creat şi instantiat deja obiectul pagesetupDialog1 la nivel de formă ): 


d ilie aid ps Click. 
ERE {object sender, system. EventArgs e) 


i pageSetupDialog1- PageSettings = new PageSettings(); 


if (pageSetupDialogl.ShowDialog() == DialogResult.OK) 


i = . 
Eraneeoehne ti DefaultPageSettings = 


... pageSetupDialogl. Pagesettings; 
) we ote iy 
} ‘ 
După ‘cum’ ‘se "observă, referința către un: obiect PageSettings 
trebuie mai întâi initializaté cu un obiect instanțiat adhoc, care mai apoi va 
primi valorile setate de către utilizator în dialogul de Page Setup ; aceste 
valori sunt preluate, la închiderea „dialogului, în setările default ale 


dpenmeatuluy 


4. Se scrie hadler de tratare a dhin printsetup din meniu (exista 
Obiectul printDialog? la nivel de formă, deja instantiat ) :. 


a manPrintSetup_Click . 
Pee: (object sender, System.EventArgs e) 


i printDialog1. PrinterSettings = new printerSettings(); 
if (printDialogi. ShowDialog () == DialogResult.OK) 
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od 2 < 
printDocument1.PrinterSettings = 
. printDialog1. PrinterSettings; 


Maniera de lucru: este aceeaşi: se instanţiază: un obiect 
Printersettings legat prin referință de dialogul printDialog1; la 
închiderea dialogului, valorile introduse de utilizator în câmpurile de editare 
ale dialogului se regăsesc stocate în obiectul instantiat mai. sus. şi vor fi 
preluate de documentul care aşteaptă pentru imprimare. - 


Exercitiu 


Să se printeze rezultatul unei interogări pe o bază de date. Să se 
asigure imprimarea informaţiilor pe două coloane. 


Exercitiu 


Să se scrie aplicația care citeşte conținutul unui fişier text din disc şi-l 
imprimă. Se va scrie cod sursă, în locul aducerii controalelor din ToolBox. 


- Rezolvare 


e Se declară în clasa aplicaţiei un obiect public PrintDocument pă; 
adăugarea se poate face şi cu MouseRight pe clasa formular; 

e Se pun gi se tratează pe meniul principal opțiunea Fisier, cu 
_ Suboptiunile de open şi Close, pentru fişierul text de imprimat / 
penalizat . i 


private void besohidatobjeck sender, System. EventArgs e) 
{ . ` K à $ CO E 
try { fisier = new StreamReader {("C:\\MyFile. txt"); jo: 
„catch (Exception ex) { MessageBox. Show (ex.Message); } 


private void Inchide (object sender, System.EventArgs e) _ 
{ 
fisier.Close(); 


y 


fisier este un obiect de tip StreamReader declarat membru al clasei 
formular Ex_Print. 
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Observaţie. 


S-ar fi putut invoca un control OpenFileDialog, respectiv 
SaveFileDialog, pentru generalizare 


e Pe un buton sau tot pe o opțiune ( Imprima ) din meniul Fisier se 
instanţiază un obiect printDocument, se anunță funcția de tratare a 
evenimentului PrintPage al documentului şi se lansează metoda pentru 


imprimarea câte unei pagini: 


private void printButton_ Click (object sender, EventArgs e) 
( ; 
try 


printFont = new Font ("Arial", 10); 
// instantiere font declarat in forma 
pd = new PrintDocument(); 
pd.PrintPage += new 
PrintPageEventHandler (this. pda_ PrintPage) ; 


pd.Print(); 
} 


catch (Exception ex) 
{ MessageBox.Show( “Fisier nedeschis: "+ex.Message) ; } 


e Funcția de mai sus e declarată automat ca functie de tratare a 
evenimentului click de mouse, daca’ cu Designer-ul am stabilit in 
Properties / Events acest lucru; dacă nu am lucrat cu Forms 
Designer, această legătură se va face manual, sub forma: 


this. printButton. Click += 
new “System: EventHandler (this. -printButton_ click) 1 


Ultima comandă din funcţie, pd. Print ().;_ inițiază procesul | de 
imprimare, care lansează la rândul lui ‘fonola 4 Ti PrintPage, pentru 
fiecare pagină de imprimare; acest lucru se întâmplă deoarece cu o linie mai 
sus am declarat pentru documentul de imprimare pd, funcția pd_PrintPage 
drept funcție de tratare a evenimentului PrintPage, ( prin apelul 


PrintPageEventHandler (pâ_PrintPage) ): 


pd.PrintPage += new PrintPageEventHandler (this.pd_PrintPage) ; 
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e Funcţia de tratare ar putea arăta astfel: 


privată void pd_PrintPage 
(object sender, PrintPageEventArgs ev) 

{ i 

float liniiPePagina = = 0; 

float yPoz = 0; int nr = 0; 

float stgMargine = ev.MarginBounds.Left; 

float susMargine = ev. MarginBounds. Top; 

string linie_txt = null; e . A 


// Calcul numar de linii / pagina 
liniiPePagina = ev.MarginBounds.Height / 
printFont.GetHeight (ev.Graphics) ; 


// Imprima linie cu linie din fisier 
while(nr < liniiPePagina && i 
i ((linie_txt = fisier.ReadLine()) != null)) 
{ 
yPoz = 
~ ‘susMargine + (nr * printFont.GetHeight (ev.Graphics) ); 
ev.Graphics.DrawString 
(linie_txt, printFont, Brushes. Black, 
S stgMargine, yPoz, new StringFormat() ); 
nr++t; 


) 


// in cazul in care mai exista inca linii in fisier 


if(linie_txt != null). ` 
EET ev.HasMorePages = true; 
else ev.HasMorePages = false; 


Se observă că MarginBounds fiind dreptunghiul de imprimare, el 
permite calculul numărului de linii pe o pagina pornind de la înălțimea 
dreptunghiului şi înălțimea fontului. Există mai multe forme supraîncărcate 
ale funcției DrawString; aici s-a optat pentru a da şirul de scris, fontul, 
pensula, poziţia de scris sub forma a două valori float şi un format ESA 
de conversie a șirului. 

„__ Poziţia fiecărei linii s-a calculat în funcție de marginea de sus a 
paginii, numărul liniei dè scris Şi înălțimea unei linii ( depinzând de 
înălțimea fontului ). Je 

Variabila booleana ev.HasMorePages solicită sau nu relansarea 
automată a procesului de imprimare a unei pagini, în funcție de existenţa sau 
inexistenţa altor linii neimprimate încă. 
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2. Previzualizarea documentului de imprimat 


Pentru partea de previzualizare, lucrurile stau aproximativ la fel. 
Este nevoie de un obiect PrintPreviewDialog Care se poate aduce din 
Toolbox; se crează astfel automat un obiect printPreviewDialog1 


private PrintPreviewDialog printPreviewDialog1; 


ale cărui metode pot fi invocate pentru activarea dialogului şi 
previzualizarea paginilor de imprimat. 


Diferenţa între a trage din Toolbox sau a declara un obiect prin 
program în clasa formei constă în faptul că Forms Designer pune el 
declaraţia referintei şi instantierea obiectului, iar selectând obiectul plasat în 
- partea de jos a formei, putem cu Properties, adăuga direct funcția de tratare 


a evenimentului PrintPage: 


Prin fixarea proprietăţii Document a printPreview-ului pe obiectul 


__printDocument pă, acesta din urmă va considera că suportul de afişare nu 


mai este imprimanta, ci chiar dialogul de previzualizare. - 

Pe Click “opţiune de meniu se instanțiază obiectul de tip 
PrintDocument gi i se încarcă delegatul asociat evenimentului. 
PrintPage cu metoda furnizată de noi: 


private void opt_previewClick Ue wh aa 
{object sender, System.EventArgs e) 
{ oa : i a ae 
pd = new PrintDocument (); 
pd.PrintPage += new PrintPageEventHandler 
( this. preview. PrintPage ); 
_. printPreviewDialogl.Document = pd; 
printereviewbialogi. ‘ShowDialog () ; 


Rate 
wid it 


aid 


i Pt S l 2 . gs cât i 

La vizualizarea dialogului: se declanșează automat şi metoda 
Print a documentului, care declanşează la rândul ei “evenimentul 
PrintPage, tratat de noi prin funcția preview_PrintPage. 


private void preview PrintPage 
(object sender, PrintPageEventArgs ev) 


{ 


string linie txt = "Text de scris in document"; 


Font fnt = new Font("Lucida Handwriting", 16); 
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sa SoTiaBrush pns. = new PUI Maia cand Ci causa be 


ev. ernie FillRectangle(Brushes.Red, 
© new REecangLe (200, 200, 100, 100)); 

r FAA colt stanga-sus să i E 

float x .=.150.0F; float y= 150.0F; 
ev.Graphics. DrawString(linie_ txt, fnt pns, X; Y); 
ev.HasMorePages = true; 
float liniiPePagina = 0; l 
float yPoz = 0; int nr =10; 
float stgMargine = ev.MarginBolinds.Left; : 
float susMargine = ev.MarginBounds.Top; 
linie_ txt = null; ey’ ss ; 


ott Calcul numar de linti ra pagina. ` i i 
liniiPePagina = ev.MarginBounds.Height / 
fnt .GetHeight (ev.Graphics); 
‘// Vizualizeaza linie cu linie 
while(nr < liniiPePagina && 
. ({linie_txt=fisiẹr.ReadLine()), != null)) 
{ a : 
yPoz = susMargine + (nr * fnt.GetHeight (ev. Graphics) ) ;: 
ev. Graphics. DrawString(linie txt, fnt, Brushes. Black, 
ra „să zo  , StgMargine, yPoz, new pre LaBoaaa tsi 


nr++; 
) 
// cazul in care exista mai multe cei in fisier 
if (linie_ txt t= null) gi ee 
ev.HasMorePages = ence 


else ev.HasMorePages = false; 


Piten Dae bine’ să“ asociem” âceeaşi funcție de tratare a 
evenimentului PrintPage folosită şi la imprimarea propriu-zisă; aici am 
urmărit însă funcționarea de sine stătătoare a previzualizării, independent de 
imprimare. as fe te, 


f ue 
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Transformări în pagina de imprimare 


ri i 


Contextul grafic al imprimantei permite şi scrierea sub diverse 
unghiuri a textului; în acest ` scop | el dispune “de metoda 
RotateTransform(): - : i Š 

Unghiul se dă în grade, în sens invers trigonometric 
Există de asemenea funcţii pentru, translatii TranslateTransform() și 
scalări ScaleTransform(). Combinarea lor permite. obtinerea de, efecte de 


enul: 
: - trasarea unor figuri complexe, cu etichetări sub diverse unghiuri; 
e mirroring sau imprimarea "în oglindă" necesară la imprimarea pe 
foaie de calc a negativului tipografic. 
e scrierea răsturnată, când foaia de imprimare având un colt îndoit, 


trebuie introdusă invers. 
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Efectele trebuie calculate atent, deoarece: 


e ele se cumulează la mai multe apeluri succesive pentru oricare din 
cel trei funcții amintite; 


e schimbând unghiul, se schimbă şi direcția axelor Ox şi Oy şi implicit 
interpretarea valorilor curente pentru abscisa şi ordonata punctului de 
scriere. 


Rectangle cadru=new RectangleF 
_ (500,500,300, fnt. GetHeight (ev. Graphics) ) ; 
Pen cr=new Pen (Brushes. Black,2); 


for (int k=0; k< 3; k++) 
{ 
ev.Graphics .RotateTransforn (20*k) ; 
cadru.X+=100*k; cadru.Y-=100*k; 


ev.Graphics.DrawRectangle 
(cr, cadru.X,cadru.Y, cadru.Width, cadru.Height) ; 


ev.Graphics.DrawString(""+k+" Rotire text", fnt, ‘ 
Brushes.Black, cadru, new StringFormat()); 


ev.Graphics.RotateTransform(-60); // revenire la normal | ge. 


int cx.= (int)ev.Graphics.ClipBounds.Width, 
cy = (int)ev.Graphics.ClipBounds. Height; 


ev.Graphics .TranslateTransform( 100, 100); 
ev.Graphics. Spa ETEEDR STIIS dy 1); 
_fnt = new Font ("Arial Black", 40); : PETERT SES Ă pia ph 
ev.Graphics .DrawString(" Mirorring", fnt, Brushes.Black, œ 
7650, 830, new StringFormat () ) ; 


Secvența de mai sus, inserată în funtia’ preview _PrintPage, are drept 
consecință o previzualizare de genul următor: ES l ; ; 
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'3. Imprimarea documentelor utilizând generatorul de 
rapoarte CrystalReports 


Mediul de programare .NET permite dezvoltarea de aplicații 
software de o mare diversitate. Accesul facil la baze de date de diferite tipuri 
a permis dezvoltarea de aplicații performante şi în domeniul gestiunii 
volumelor mari de date. Generarea rapoartelor prin mijloacele prezentate în 
paragrafele anterioare este destul de anevoioasă şi impune un efort mare de 
programare. Ne referim şi la faptul că imprimarea unor fişe cu un format 
impus, spre exemplu a unor fluturaşi individuali cu date despre salariul 
lunar, devine o operație migăloasă fără un instrument vizual de construire a 
rapoartelor. ae 
CrystalReports este generatorul de rapoarte inclus în mediul NET. 
El funcţionează si ca o aplicaţie de sine stătatoare şi poate fi invocat şi din 
aplicaţii de utilizator. fay 

| ‘Pentru a. genera un raport cu aplicația CrystalReports din C# se vor 
parcurge etapele următoare: 

1. se crează un proiect de tip Windows Application; 

2. se adaugă la proiect un nou Item de tip Crystal Report (în fereastra 
Solution Explorer, click dreapta pe numele proiectului Add / Add 
New Item, se deschide o fereastră de dialog, din panelul Templates 
se selectează Crystal Report; numele raportului se generează, iar în 
cazul în care se doreşte, el poate fi schimbat doar editând noul nume; 

3. se apasă butonul Open care va crea un fişier cu numele raportului şi 

= extensia ypt şi se invocă aplicația Crytal Reports care permite 
decrierea vizuală a raportului ca în figura 9.1. 

4. pe lîngă fereastra în care se va descrie vizual raportul având în 
vedere | structura, unui raport: header-ul raportului, header-ul 
paginii, Details? conţinutul propriu-zis al paginii, footer-ul paginii 
şi footer-ul raportului, se mai deschide şi fereastra | 

- care conţine elemente ce vor fi adăugate la raport, ca d 

e sursa de date; l 
© câmpuri independente; : Ava 

e formule sub forma de câmpuri calculate; 

e câmpuri speciale cum ar fi data şi ora sistem; 

e numărul paginii curente; 

e numărul înregistrării curente etc. 


e exemplu; 
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Fig 9.1 Aplicația Crystal Reports 
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5. Construirea raportului presupune în primul rînd definirea unor 
elemente de ansamblu, cum ar fi: 


setarea imprimantei şi a mărimii paginii (click dreapta pe raport 
şi se alege opțiunea Designer / Printer Setup); 

stabilirea marginilor (click dreapta pe raport şi se alege opțiunea 
Designer / Page Setup); i 

dacă se doreşte suprimarea unor secțiuni din raport sau 
adăugarea de noi secțiuni (de exemplu încă o secțiune Details 
care să conțină elementele de imprimat pe verso-ul unei pagini) 
sau printarea secventiala a înregistrărilor pînă se completează 
pagina sau câte o înregistrare pe pagină etc (click dreapta pe 
raport şi se alege opțiunea Format Section; se deschide un 
dialog cu două panel-uri: cel din stânga conţine secțiunile 
raportului, iar cel din dreapta, opțiuni referitoare. la secțiunea 


curentă); 


legarea la o. sursă de date se face selectând itemul Database 
Fields din fereastra Field Explorer, click dreapta şi se selectează 
Add / Remove Database, se deschide un dialog, în panel-ul 
Available Data Sources se stabileşte sursa de date, iar în. cel din 
dreapta se aleg. tabelele din care se vor afișa datele; în itemul 
Database Fields va apare numele tabelei şi câmpurile asociate 
ae A 


: 6. Definirea şi aranjarea în pagină a elementelor care se vor imprima în 
o raport? >` zi : 
-e adăugarea de texte statice, linii, câmpuri speciale, sigle, 


"grafice etc. într-o secțiune se face dînd click dreapta pe secțiunea 


respectivă si se selectează opţiunea Insert, după care se alege 
tipul .de element dorit pentru a fi inserat şi se editează 
corespunzător, apoi se mută în cadrul paginii în locul în care se 


‘dorește a fi imprimat, 


adăugarea în raport a câmpurilor din baza de date se face 


selectând un câmp din fereastra Field Explorer, itemul 
Database Fields şi prin drag and drop se fixează în secţiunea 
dorită şi la locul dorit în raport; 

adăugarea unui câmp de tip parametru la raport se face 
selectînd item-ul Parameter Fields, click dreapta şi se 
selectează New după care apare un dialog prin care se specifică 
în principal numele câmpului şi tipul său; se apasă OK şi numele 
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câmpului va apare ca subitem al item-ului Parameter Fields; prin 
drag and drop se fixează, în raport, în secţiunea dorită şi la locul 
dorit; 

e adăugarea unui câmp de tip formulă, la raport, se face 
selectând item-ul Formula Fields, click dreapta şi se selectează 
New, se introduce numele formulei după care apare un dialog 
prin care ea se poate edita vizual ca în figura 9.2. 


E 72 formula tditor: OF 


Fig 9.2 Editorul vizual de formule 


Formula se compune din operanzi care vor fi preluati din panel-ul din 
stanga, iar prelucrarile efectuate asupra lor implică folosirea de operatori 
(existenti in panel-ul din dreapta) şi funcţii (în panel-ul din: mijloc). De 
exemplu, construcția: UpperCase ((prod.den)) are ca scop conversia 
şirului denumire (den) din tabela prod la litere mari. Sintaxa de redactare a 
formulelor este una specifică soft-ului Crystal Reports, dar se poate alege şi 
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sintaxă tip Basic. Inchiderea dialogului se poate face cu salvarea formulei _ 
caz în care, dacă ea e scrisă corect sintactic, numele va apare ca subitem în 
itemul Formula Fields, de unde prin drag and drop se fixează în sectiu a 
dorită şi la locul dorit în raport. ae 
Integrarea raportului într-o aplicație C# presupune utilizarea pe o 
formă a unui control de tip crystalReportViewer. Legătura dintre contro] 
şi raportul propriu-zis se face prin proprietatea ReportSource a obiectului 
de tip CrystalReportViewer, adică se introduce numele cu calea către 
fişierul de tip rpt care conţine raportul. l 


Tit 


Fig 9.3 Vizualizarea raportului în vederea imprimării - 


Controlul de tip crystalReportViewer se poate configura după 


dorința programatorului prin modificarea proprietăţilor corespunzătoare. El 
are tools-uri utile pentru | 


.e vizualizarea succesivă a paginilor, 
e afişarea primei / ultimei pagini, 
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e zoom pe document 

e conversie document într-un alt format, 

e trimiterea documentului spre tipărire la imprimantă etc. 

Aceste operații sunt deja implementate şi sunt disponibile prin 
intermediul butoanelor din bara de instrumente a controlului după cum se 
poate vedea în figura 9.3. 


Din cele prezentate lucrurile sunt relativ simple şi țin mai mult de 
utilizarea soft-ului Crystal Reports decât de programarea în C#, acest lucru 
se datorează în principal faptului că am lucrat cu o sursă de date deja 
constituită. 

Dacă dorim să parametrizăm un raport iar datele nu le vom prelua 
dintr-o sursă de date, ci le vom prelua din controale (variabile) existente: 
într-o aplicație C#, atunci comunicarea între aplicație şi raport nu se va mai’ 
putea face numai vizual. Pentru parametrizarea raportului se vor folosi, în 
raport, obiecte de tip Parameter Fields. 


Pentru exemplificare vom contrui o aplicație (un proiect de tip 
Windows Application ), pe forma principală Form1 vom cere introducerea 
următoarelor date: nume, prenume, numărul de ore şi salariul orar şi vom 
pune un buton Raport la apăsarea căruia se va vizualiza un raport. 

In figura 9.4 se poate observa forma principală a aplicației. 


Fig. 9.4 Forma de introducere a datelor 


Raportul se va construi cu Crystal Reports şi are forma prezentată în figura 
9.5. 
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px- Pentru a vizualiza raportul vom adăuga la proiect o nouă forma 

(Form2) pe care vom adăuga un control de vizualizare a raportului (de tip 

'crystalReportViewer, variabila fiind crystalReportViewerl) şi vom 

` stabili legătura către raportul de vizualizat ( proprietatea Report Source). 

In forma principală, la apăsarea pe butonul Raport, se va vizualiza 
fereastra Forma: 


private yoid buttonl_Click(okject sender, System.EventArgs e) 
{ 


Form2 fr=new Form2 (this); 
fr.ShowDialog(); 


} 
Accesarea membrilor’ clasei Form1 din clasa Form2 se va face 


trimițând constructorului clasei Form2 o referință la clasa Form1. i 
Constructorul clasei Form2 preia referința într-o variabilă (£p) şi prin 
intermediul ei se trimit raportului valorile introduse în forma Form1 pentru a 


fi tipărite: 


public Form2 (Form kK) 
{© ; 
Initializecomponent (); fp=k; 
// creare obiect de tip parametru 
i ParameterDiscretevalue num = 
new ParameterDiscreteValue(); 
// preluarea valorii parametrului, din controlul textBoxl 
num.Value = fp.textBoxl.Text; 


Fig 9.5 Machetă d ge os l : . 

E . 1a ce raport i é // asocierea acestul parametru ca valoare curenta a primului : 

St fixă ; : : // cimp parametru. din raport (?num) i : 

ructura fixă a raportului a fost construită folosind obiecte de tip T crystalReportViewerl:ParameterFieldInfo[0] .CurrentValue 
s.Add (num) ; 


TextObject, partea variabilă este dată de membrii de tip Parameter Fields: 
num — pentru nume, prenum — pentru prenume, nro — pentru număr de ore 
şi salo — pentru salariul orar, care apar în raport precedati de ? si de un 


// acelasi lucru pentru ceilalti parametri 
ParameterDiscreteValue pren = : 
i new ParameterDiscreteValue(); 


membru de tip Formula Fields; spre exemplu, sal care are ca scop calculul © <  pren.value = fp. textBox2. Text; Bi, el ing 
salariului după formula: nro * salo, are în editorul de formule sintaxa: — d crystalReport Viewer! . ParameterFieldInfo(1) .CurrentValue 
(?nro) * (?salo). Se poate observa în figura 9.5 că un câmp de tip formulă i i . e N aa „s.Add(pren) ; 
este precedat de @. ParameterDiscreteValue no = op pi ore : a 
i i A F A new ParameterDiscreteValue(); 
P : | | " no.Value = fp.textBox3.Text; 
Valorile parametrilor se vor prelua din forma principală şi se vor afişa crystalReportViewerl _ParameterFieldInfo [2] .Currentvalue 


în raportul construit anterior. s.Adă (no) ; 


ParameterDiscreteValue so = 


Prin construirea raportului se generează fişierul cu nume implicit | | is 
CrystalReportl.rpt care contine descrierea raportului si in plus la proiect so.Value = fp.textBox4 pudici Rai aaa 
apar încă două obiecte: crystalReport1 şi CacheCrystalReport1. erys talReportViewer1 : ParameterFieldInfo [3] .CurrentValue 

. N .§.Add (so); 
} 
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i: Vizualizări splitate. Elemente de grafică 
E VIZUALIZĂRI SPLITATE. ELEMENTE DE GRAFICĂ 


După executarea: constructorului, în fereästră se va afişa raportul cu 
valorile curente, ca în figura 9.6. 


1. Docarea şi ancorarea controalelor. Vizualizări splitate. 
Panel-uri 
2. Elemente de grafică 


1. Docarea si ancorarea controalelor. Vizualizări splitate. 
Panel-uri a * 


Controalele mai dispun de o proprietate interesantă numită Dock, ea 
stabileşte de care margine a containerului să se “lipească” unele controale : 
Left, Right, Top, Bottom sau Fill, când trebuie să umple intreg 
cohtainerul ( uzual, forma). 

Proprietatea Dock nu trebuie confundată cu proprietatea Anchor, care 
stabilește reperul indicat de data aceasta prin două margini (Left - Top, 
Right -rop etc.) față de care controlul va păstra aceeaşi distanță (inițială) în 
momentul în: care containerul se redimensionează ( spre exemplu, la 
momentul execuţiei, utilizatorul trage de colțul dreapta-jos al formei, 
marind-o). ` ape ie l îi i 

Din considerente estetice, docarea nu se aplică unor controale gen 

“Button sau Label, dar pare justificată pentru controale de tip TextBox, 
ListBox etc., asigurând legarea lor de o margine și extinderea lor la 
dimensiunea întregii margini. PELE AE oA Oe RE a 
i Dacă un control nu este vizibil pe forma, sau selectarea lui este į 
b dificilă datorită dimensiunii mici sau plasării în spatele altui control, se i 
iipoate folosi fereastra Properties, care are in partea superioară un | 
i ComboBox, în care apar toate controalele formei, putând fi astfel uşor ! 
i selectate. Pets fa 


Controlul Splitter | 
2 Pert stig Se d : $ i 
În ToolBox există un control interesant numit Splitter, care adus pe 
o formă cu două controale, se poziţionează automat între ele. El apare ca o . 
linie punctată, iar pentru a-i mări vizibilitatea îl putem colora ( proprietatea 
BackColor) într-o culoare aprinsă. € l 


Fig 9.6 Afişarea raportului cu date preluate dintr-o formă 
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La momentul execuţiei, dacă se trage de splitter, controalele din 
jurul său se redimensionează automat, unul mărindu-se, altul micşorându-se. 
Splitter-ul lucrează diferit în funcție de proprietatea sa Dock: 
implicit ea este Left. Dacă pe formă se găseşte deja un control docat Left, 
splitter-ul se poziţionează în continuarea controlului, respectiv pe marginea 
„dreaptă a acestuia. Mişcarea splitului la momentul rulării, determină 
redimensionarea controlului de care este. docat. Se poate deduce ușor 
comportamentul dacă proprietatea Dock a splitter-ului se alege Right, 'Top 
Sau Bottom; putem aşadar să scindăm o fereastră pe orizontală şi pe 
verticală, obținând astfel mai multe zone funcţionale. 

O întrebare firească este ce se întâmplă când avem mai multe 
controale pe formă sau sunt controale « nedocabile », din considerente 
estetice. 

Soluţia o oferă controlul Panel, din ToolBox. El are două funcțiuni 
majore : l l 
e oferă suportul pentru desenare (canvas), dispunând de un context grafic 
-ce poate fi extras deoarece panel-ul recunoaște evenimentul Paint; - 

e acționează drept container ( control care tine alte controale), iar lipit de 
un splitter, se mută luând cu el toate controalele pe care le conține. A 
doua funcțiune. poate fi suplinită şi printr-un control GroupBox, dar 
acesta oferă mai puține facilități... . 


2. Elemente de grafică 


Suportul pentru reprezentările : grafice este oferit în Visual C# de 
biblioteca de clase .NET prin intermediul clasei Graphics. Ea conține toate 
funcţiile de trasare grafică, precum şi informațiile despre zona client, funcţii 
pentru principalele transformări matematice, cum ar fi curbe Bezier, rotația, 
translatia, scal t 

Clasa 
derivarea unei clase noi. an E e 
Nu are constructor, obiectele ei fiind obținute pe căi indirecte, dintre care 
cele mai frecvente sunt prezentate în continuare. 


este sealed şi deci nu putem moşteni din ea prin 


1. Evenimentul Paint are argumentul PaintEventArgs, Care are la. 
rândul lui proprietatea Graphics ce referă un obiect Graphics 
asociat suprafeței grafice a obiectului ce a iniţiat Paint-ul. a 

2. Apelând funcţia CreateGraphics () specifică unui control. 
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private void btn click (object sender, System.EventArgs e) 


‘ Graphics g = puttonl .CreateGraphics () ; 


g.DrawEllipse (new Pen (Color.Red,2), 10,10,20,20); 
T de mai sus trasează o elipsă çhiar pe suprafața unui piion oe 
Coniează unde pun codul pentru trasare; pus în n pei eee 
vede, căci forma se retrasează. Pus pe click buton ca mai Sus, acă for ee 
this.ResizeRedraw = true; ŞI s-a acoperit prin a. 
butonul, când acesta reapare nu mai are desenul şi trebuie din ie al ne 
3. Apeland Graphics. FromHwnd (this -Handle) şi furnizan 
handler-ul ferestrei formei sau controlului repectiv. 


4. Apeland metoda statică Graphics .FromImage (bmp), care 
pornind de la o imagine ( declarată sub forma Bitmap bmp; ) 
- returneză un obiect grafic asociat acesteia. 


Exercitiu 


Să se exemplifice elementele de bază ale unei reprezentări grafice, 


folosind contextul grafic al formei principale a aplicaţiei, obținut din blocul 


de parametri ai funcţiei de tratare a evenimentului Paint al formei. 


Rezolvare 


j ride void iat ie 
ene over paint (System.Windows . Forms . PaintEventArgs pe) 


i carea:metodei din baza 
\ base.onPaint (pe); // eventual, învocarea'm | 


i iz = true; 
this .ResizeRedraw 
// invocare Paint la orice redimensionare 


// a se testa si cu proprietatea pe false 
//obtinere obiect grafic din parametrii lui Paing 
Graphics g = pe.Graphics; pi 


// extragerea dreptunghiului in care se poate desena 


j = i tangle; 
le zonaClient=pe.ClipRec | l 
ute folosi si proprietatea ClientRectangle a formel 


// Rectangle zonaClient "= ClientRectangle; : 


Brush fundal=new SoliaBrush (Color .White) ; 


i ient); 
ctan le(fundal, zonaClien ; 
Sete F //coloreaza alb zonaClient 
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zonaCclient .X+=5; zonaClient.Y+=5; // margini 
zonaClient.Height-=10; zonaClient.wWidth-=10; 
// Gxreptunghi de vizualizare 


Pen creionRosu = new Pen(Color.Red,2);.. // rosu, grosime a. 
g.DrawRectangle(creionRosu, zonaClient) ; 


*// edordonate calculate functie de dimensiune fereastra; ` 
if PERETE se redimensioneaza odata` cu rereastra” 


Point stgsus. = new Point (zonaClient. x, zonaclient. Y); j 
Point drtJos = new Point ( zonaClient. X+zonaClient. Width, 
zonaClient. Y+zonaClient.Height ); 


g.DrawLine(creionRosu,stgSus, artJos); ‘ 
SolidBrush pnsGalbena = new SolidBrush (Color. Yellow) ; 


. PointF p = new PointF(' zonaClient.xX+zonaClient. width/4, 
zonaClient.Y+zonaClient. Heo > )3 


SizeF s =new SizeF (zonaClient. Width/2,zonaClient. -Height/3); 
RectangleF drept = new , RectangleF (p, si 
etapei coe 7/ figuri pline 
// lucru in coordonate absolute; 

// figurile raman pe loc la redimensionare fevédstra - 
SizeF size=new SizeF(100, 150); 


PointF point=new PointF(20,40); i 
RectangleF rèc =new RectangleFr (point,size) ; 


co A 


Pen pa=new Pen (Color.Blue, 3); // albastru grosime 3 
g.DrawEllipse(pa,rec); 


Point pl=new Point (100,100), . 

p2 = new Point(50,150), p3=new Point(); 
p3.X=150; p3.Y=150; 
“Point []vp=new Point [3j(p1, p2, p3);.- 


SolidBrush pnsAlbastra = new SolidBrush(Color. Blue); 
g. FillPolygon (pnsAlbastra, VP) i. 


Se observă că există Versiuni duble ale unor clase, în funcție de tipul 


coordonatelor folosite, int sau float: Point, PointF, Rectangle, 
RectangleF, Size, SizeF. 
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Atunci cînd-se desenează text, programatorul trebuie să calculeze 
coordonatele de la care începe scrierea, având grijă să avanseze, linie cu 
linie. O modalitate de calcul al coordonatelor se bazează pe extragerea 
dimensiunii textului scris ( lungime şi înălțime ) în funcție de numărul de 
caractere şi de fontul cu care este scris textul: 


SizeF 1g lat. grfx .Measurestring (sir, font); 


Dacă interesează aceste coordonate doar pentru centrarea textului, o 
variantă mult mai comodă uzează de facilitățile unui obiect de tip 
RE 
StringFormat,. care preia toată sarcina alinierii: să 


StringFormat sf; sf. Alignment = StringaAlignment . Center; 
Programatorul .nu trebuie decât să aleagă din “enumerarea 


StringAlignment, pe cea dorită. _ 


ResizeDraw = true; etse o proprietate a formei care solicită ca la fiecare 
redimensionare să se apeleze şi funcția Invalidate(), adică funcția de 
retrasare a ferestrei prin invocarea metodei Paint. 


Alpha blending este o tehnică de amestecare a culorilor, astfel încât 
la suprapunerea a două desene este creată senzaţia de transparență şi de 
mixare 'a culorilor, observându-se astfel intersecția obiectelor. Tehnica 
alpha blending este disponibilă prin intermediul culorii MG astfel, la 
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crearea culorii: pensulelor. se indică drept prim parametru un factor de 

mixare a culorilor, care ia valori tot între 0 şi 255: s 
SoliaBrush trnsRedBrush = bai uzi 

new SolidBrush (Color. Fromârgb (120, 255, 0, 0)); 


Funcţia de, mai jos declanşată la un click de mouse pe formă, 
calculează centrele și razele a trei cercuri astfel încât acestea să aibă tot 
timpul zone suprapuse; în felul acesta, colorarea cu tehnica alpha blending 
este mai bine pusă în evidență, mai ales că ea se aplică între culorile 
elementare: roşu, verde şi albastru. : 


private void Formi_Click(object sender, System:EventArgs e) 
Graphics g= Graphics .FromHwnd(this.Handle) ; 
// Pensule transparente cu alpha blending 


SolidBrush trnspRosie = Stee he : 

new SolidBrush (Color.PromArgb (120, 255, 0, 0)); 
SolidBrush trnspVerde = 

new SolidBrush (Color. FromArgb (120, 0, 255, 0)); 
SolidBrush trnspAlbastra = 

new SolidBrush (Color. FromArgb (120, 0, 0, 255));. 


this .ResizeRedraw = true; 
float ` triBaza = this.ClientRectangle.wiâth/4; 
float triInaltime =(float)Math:Sqrt(3)*triBaza/(float)2; 


© float. x1 = 40;: float’ y1 =" 40; # 
_g.FillEllipse (trnspRosie, xl, yl, ;2*triInaltime, 
2*triInaltime) ; 
g-FillBllipse(trnspVerde, xi + triBaza/2, yl + triInaltime, 
ake fa a * > 2*triInaltime, 2*triInaltime) ; 
g.FillEllipse (trnspAlbastra, x1 + triBaza, yl, 
. 2*triInaltime, 2*triInaltime) ; 


A 2 A A 
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Exercitiu 


Să se scrie o funcţie pentru reprezentarea grafică a unei curbe 
oarecare prin trasarea ei, pixel cu pixel. l 

Rutina de trasare grafică porneşte. de la conceptele de fereastră şi 
vizor. Scalarea imaginii se va face astfel încât maximul şi minimul funcției 
să poată fi reprezentate în vizor. . l . E 

Testul de generalitate se va face apelând rutina pentru o parabolă şi 
respectiv, pentru o sinusoidă. i 


Rezolvare 


Elemente pregătitoare: pie a 

e O structură de date care grupează informaţiile preluate din fereastra 
utilizator şi care vor fi transmise clasei responsabile cu reprezentarea 
grafică. 

e Un delegate ce conţine funcția de reprezentat grafic. 


De data aceasta, programul este structurat pe două clase, pornind de 
la ideea că nu trebuie totul îngrămădit în clasa Forml. Ea trebuie să 
concentreze doar elementele ce tin de interfața grafică cu utilizatorul: 
preluarea datelor sau parametrilor de reprezentare grafică, butoane de 
control sau pentru alegerea tipului de reprezentare grafică. Misiunea ei se 


181 


Vizualizări splitate. Elemente de grafică . 


încheie după ce a împachetat datele şi parametrii şi le-a transferat funcției de 


Vizualizări splitate. Elemente de grafică 


private void InitializeComponent |) 


trasare grafică, prin lansarea metodei de tratare a evenimentului Paint. t this.panell = new System.Windows . Forms A ae 
Desi exista o clasă Graphics care conține elementele de bază, inclusiv this pure = iii sys Cee needs “Forms . Text Box O; ' 
metodele, necesare reprezentării grafice, s-a preferat definirea si a unei clase this.1bC = new system. Windows . Forms . Label () 
de utilizator, grafic, care să înglobeze culori, pensule, creioane, funcții de this.tbC = new System. Windows . Forms .TextBox() ; 
reprezentare grafică mai complicate, create de programator. this: label4 = new: System. Windows Poras- Baber] 
În moment tratării evenimentului Paint se instantiaza obiectul grafic a i as ee a li te eae age, i 
de utilizator, i se pasează comer! Graphics şi i se predă controlul prin this .tbA = new System.Windows.Forms .TextBox() ; 
apelul g.Arata(e). this.label2 = new System.Windows .Forms.Label () ; 
La rândul ei, funcția definitivează contextul grafic completându-l cu this.tb = new System.Windows . Forms „TextBox() ; 
elemente care nu au fost date din exterior de către utilizator. eee i see ae e ei d ge pe ati ae 
Pentru reprezentarea grafică propriu-zisă, clasa grafic preia datele şi RR , casta i new, Sys tem. Windows f Se eeay )i 
contextul grafic al formei, efectuează calculele matematice, setează this.radioButton2 = new System.Windows.Forms.RadioButton () ;, 
parametrii grafici doriți şi trasează graficul. this.radioButtonl = new System.Windows.Forms.RadioButton () ; 
this.panel2 = new System.Windows .Forms.Panel (); 


this.panell.SuspendLayout (); 
this. groupBox1 .SuspendLayout () ; 
this. SuspendLayout () ; 


using System; 
using System. Drawing; 
using System.Collections; 


using System. ComponentModel; II 
using System.Windows.Forms; // paneli- interfata cu utilizatorul 
ff | 


using System.Data; 
i this.panell.Controls.Add(this.mes) ; 


this.panell.controls.Add(this.1bcC) ; 


namespace graf_pixel 
this.panel1.Controls.Add(this.tbc) ; 


{ ; i , ; 
publie class, Formi : System.Windows.Forms.Form this.panel1.Controls.Add(this.label4) ; 
{ i this.panel1.Controls.Add(this.tbB) ; 


this.panell.Controls.Add(this.label3) ; 3 A 
this.panell.Controls.Add(this.tbA) ; A a <8 
this.panell.controls.Add(this.label2) ; 


private System. ComponeéntModel. Container components = null; 
public Formi() 


{ 
InitializeComponent () ; this.panel1.Controls.Adăâ(this.tb); ` 
) this.panel1.Controls.Add(this.label1) ; 


this.panell.Controls.Add(this.ta) ; 


protected override void Dispose( bool disposing ) this.panell.Controls .Add(this.groupBox1) ; 


{ l this.panel1.Dock =. System. Windows .Forms.Dockstyle.Left;... 
+ 4if( disposing ). Lot a a this.panell.Location = new System. Drawing. Pere (Os Di. 
Cas a «gi Ader da ee this.panell.Name = "panelt"; 23 
i if (components t= null) 7 Sn rr en pha oo Drawing. size(176, 293); Pees 
{ n, . s.pane abIn = ers 
components.Dispose(); // 
} // mes 
} : // 
base.Dispose( disposing ); this .mes.Location = new System.Drawing.Point(0, 120); 
} this.mes.Name = "mes"; 


this.mes.Size = new System.Drawing.Size(160, 20); 
this.mes.TabIndex = 11; 
this.mes.Text = ""; 

ak 


#region Windows Form Designer generated code 


i 182 183 


Ë Vizualizări s litate. Elemente de grafică 


Vizualizări splitate. Elemente de grafică ` 


// ibe JE 
: iI A // label2 
this.1bC.Location = new System.Drawing.Point (16, 88); 77 


this.1bC.Name = "1bC"; 
this.1bC.Size = new System.Drawing.Size(9, 16); 
this.1bC.TabIndex = 10; 


this.label2.Font = new System.Drawing.Font 
("Microsoft Sans Serif", 10F, 
System. Drawing.FontStyle.Bold, 


iti lea e d System.Drawing.GraphicsUnit . Point, ((System.Byte) (0) ) 
); | | 
Vee this.label2.Location = new System.Drawing.Point(128, 160); 
< this.label2.Name = "label2"; 


this.tbC.Location = new System.Drawing. Point (32, 88); 


this.label2.Size = new System.Drawing.Size(16, 23); 
this.tbC.Name = "tbc"; 


this.label2.TabIndex = 4; 


this.tbC.Size = new System. Drawing. Sizetag; 20); this.label2.Text = "]"; 
this.tbC.Tablndex = 9; . i 
this.tbC.Text = "1"; _// tb- dreapta intervalului de trasare 
this.tbC.Leave += new System.EventHandler (this.Pleaca) ; 77 
E this.tb.Location = new system. Drawing. Point (96, 160); 
by Laberg this.tb.Name = “tb"; 
a this.tb.Size = new System.Drawing.Size(24, 20); 


this.label4.Location = new System.Drawing.Point (16, 56); 


i this.tb.TabIndex = 3; 
this.label4.Name = "label4"; 


; this.tb.Text = "10"; 
this.label4.Size = new System.Drawing.Size(9, 16); /1 
this.label4.TabIndex = 8; d // labell 
this label4.Text = "B"; Tf i 
// this.labell.Font = new System.Drawing.Font 
A tbB ("Microsoft Sans Serif", 10F, 


System.Drawing. FontStyle.Bold, : 
System.Drawing. GraphicsUnit.Point, ((System.Byte) (0)) 


i 
this.labell.Location = new System. Drawing. point (32, 160); 


this.labell.Name = “labell"; 


this.tbB.Location = new System.Drawing.Point(32, 56); 
this.tbB.Name = "tbB"; 

this. tbB.Size = new System. Drawing. Size(48, 20); 
this.tbB.TabIndex = 7; 


this.tbB.Text = "1"; ; i this.labell.Size = new System. Drawing. size (16, 23); 
this.tbB.Leave += new System. EventHandler (this. Pleaca); this.labell.TabIndex = 2; : : 

a this.labeli.Text = "["; 

// label3 // 

ŢI = i ; // ta - stanga intervalului de trasare 
this.label3.Location = new system. Drawing. Point (16, 24) 71 i 
this. label3. Name ="“label3"; i : this.ta.Location = new System. Drawing. Point (56, 160).; 
this.label3.Size = new System.Drawing.Size(9, 16) ; this.ta.Name = "ta"; ca rie 


this.label3..TabIndex = 6; 


this.ta.Size = new system. Drawing. Size (24, 20); 
this.label3.Text = "A"; Sale 


this.ta.TabIndex = 1; 


this.ta.Text = "-10"; 
// tha $ 
< i // groupBoxi - functiile de trasat 
this.tbA.Location = new System.Drawing.Point(32, 24); i 


this.tbA.Name = "tba"; 

this.tbA.Size = new System.Drawing.Size(48, 20); 
this.tbA.TabIndex = 5; i 

this.tbA.Text = "1"; 

this.tbA.Leave += new System.EventHandler (this. Pleaca); 
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this .groupBox1.Controls.Ađd(this. rađdioButton2); 
this .groupBoxl .Controls. Add(this.radioButton1l); 
this .groupBoxl. Location = 

ii j new System.Drawing. Point (24, 192); 


this .groupBox1. Name = "groupBoxl"; 
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Vizualizări splitate. Elemente de grafică - Vizualizări s litate. Elemente de gra 
this.Text = “Grafic prin pixeLâria 
this.panell. ResumeLayout (false); 
this.groupBoxl1 . ResumeLayout (false) ; 


Esterii ry oupBoxl . Size = new- System. -Drawing.Size(136, 88); 
this .groupBox1l.Tablndex = 0; 
this .groupBox1.TabStop = false; 


this.groupBoxl.Text = "functia"; this .ResumeLayout (false) ; 

Jf } i 

// xradioButton2 - optiune sinus #endregion 

// 
this. radioButton2.Location = [sTAThread] 
new System.Drawing.Point (16, 48); static void Main() 
this.radioButton2.Name = "radioButton2"; { f : zi pati yi 
this. radioButton2.Tablnăex = 1; Application.Run (n i 
this.radioButton2.Text = "sin"; } 
this 


private system. Windows . Forms . Panel panell; 


.radioButton2.CheckedChanged += new System.EventHandler private system.Windows .Forms . Panel panel2; 


(RES sac ot Peng chechedeheriged) 


4 radioButtoni - optiune paral private system.Windows . Forms . GroupBox bila et ` 
i j nr Button; 

n ; j i 1 private system. Windows .Forms .RadioButto adio 

/f 


private system.Windows . Forms . RadioButton radioButton2; 
private system.Windows . Forms .Label label1; 

private system. Winđows . Forms . Label label2; 

private system. Windows . Forms . TextBox ta; 

private system. Windows . Forms . TextBox tb; 

private system. Windows . Forms . TextBox tbA; 

private system.Windows . Forms . Label label3; 

private system.Windows . Forms . Label label4; 

private system.Windows . Forms . TextBox tbB; 

private system .Windows . Forms . Label 1bc; 


this.radioButtonl.Checked = true; 
this.radioButtonl.Location = A 

new System.Drawing.Point (16, 16); 
this.radioButtonl.Name = “radioButtonl"; 
this.radioButtonl.TabIndex = 0; 
this.radioButtonl.TabStop = true; 
this.radioButtonl.Text = "parabola"; 
this.radioButtonl.CheckedChanged += new System.EventHandler 
(this .radioButton1_CheckedChanged) ; 


4 panel 2 = xeprezentar € i pri vate system. windows . Forms . TextBox tbc; 
i Y j mes; 
7 private S stem. Windows . Forms . TextBox 


public date dat; //datele.de transmis 
this. panel2. 'BackColor = 


System.Drawing.Color. FromArgb{ ( (System. Byte) (255)), 

( (System.Byte) (255) ) , '((System.Byte) (192))); 
this.panel2.Dock = System.Windows.Forms.DockStyle.Fill; 
this.panel2.Location = new System.Drawing.Point(176, 0); 
this.panel2.Name = "panel2"; 

‘this.panel2.Size = new System.Drawing.Size(280, 293); 
this.panel2.TabIndex = 1; 
this.panel2.SizeChanged += f o 
new System. EventHandler (this. panel2_ sizeChanged) ; 
this.panel2.Paint += . 
new System. Windows. Forms . PaintEventHandler 
(this.panel2_Paint); ' 


te void panel2_ Paint 
cita (object sender, System. Windows .Forms. PaintEventargs e) 


{ 
dat=new date(); N 
if (radioButton1.Checked==true) dat .tip_fct=1i- 

else dat.tip_fct=2; 
try : 


{ i : : 
gat .a= Convert.ToDouble({ta.Text) ; 


dat .b= convert .ToDouble (tb.Text) ; 


) 
catch { dat.a= -10; dat.b=10; } 


4 // valori implicite pentru intervalul la, b] 

// Forml 

// iy 
this.AutoScaleBaseSize = new System.Drawing.Size(5, 13); { eee rT 
this.ClientSize = new System.Drawing. Size (456, 293); aat.A= Convert. oe He eae 
this.Controls.Add(this.panel2); dat B= Convert. ToDo niena, Text); 
SE B ore panell); aat.c= Convert.ToDouble ; 
this. Name = "Formi"; ) 
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dysdat-Bel;dat.cx1; ) 
// valori implicite pentru A,B,c 
//dat.tip_fct=1; 


grafic g = new grafic(dat); // context grafic de utilizator 


g-Arata(e); // cere vizualizarea lui si-i preda controlul 
} 


// retrasare grafic la redimensionare panel 
private void panel2_SizeChanged 


(object sender, System. EventArgs e) 
{ Invalidate (true); } 


private void radioButtoni_CheckedChangea 
(object sender, System.EventArgs e) 


{ 
if (radioButton1 :Checked) 
{ tbA.Enabled=tbB.Enabled= tbc Enabled= true; } 
else { tbA.Enabled=tbB.Enabled= tbc.Enabled= false; } 
) 


private void Pleaca (object sender, System.EventArgs e) 


(//retrasare grafic la parasire camp de eđitare param a,b,c 
panel2.Invalidate(); 


} 


private void radioButton2_CheckedChanged 


“(object sender, System.EventArgs e) 


else {dat.a/=Math.PI; dat .b/=Math.PI; } 
panel2.Invalidate(); i 
ye gt ut 


}// end class Form 


public struct date 


{ ; 
public int tip_fct; // parabola sau sinus 
public double a,b; // interval [a,b] 
public double A,B,C; // parametri parabola 


delegate double fct (double x); 
// pointer la functia de reprezentat grafic 


public class grafic 

{ 

protected Pen pen = new Pen(Color. Red; 5); 
protected SolidBrush brush; 

Color [] culori; 

date dat; 
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if (radioButton1 .Checked) (dat .a*=Math. PI; Gat.b*=Math.PI;) 


protected Rectangle vizor;-// fereastra de vizuali® 


public grafic( date d) 
// constructor context grafic de utilizator 


{ 


} 


pen = new Pen(Color.Black) ; 
brush= new SolidBrush(Color.Red) ; 
dat=d; i 


public void Arata (PaintEventArgs e) 
// preluare context de la Paint 


{ 


vizor =e. ClipRectangle; 


vizor.X+=10; 
vizor .Height-=20; 


// zona de reprezentare grafica 


vizor.Y+=10; 
vizor.Width-=20; // lasa margini 


e.Graphics .DrawRectangle (pen, vizor); 
LOt pe; 
if (dat.tip_fct==1) pf= 


Gouble yMin, yMax; 


else pf= 


new fct(f); 
new fct(Math.Sin); 


MinMax( out yMin, out yMax); 


// MessageBox.Show("Are "+yMin+" si "+yMax); 
RectangleF w = new RectangleF ( 


. (float)dat.a,; 


(float) yMin, 


(float) (dat.b-dat.a), float) (yMax-yMin) ); 


graf (pf,w,e); 


} 


double f( double x) 


double sinus (double x) 


void graf(fct pf, 


{ 


{ return dat.A * 


x*x+ Gat.B *x+ dat. c i } 


{ return Math.Sin(x); } 


RectangleF w, PaintEventArgs e ) 


double al,bi=0,a2,b2=0,x,y,div; int oldx,. oldy; 


int 


vl=vizor.Left, vt= 
vb=vizor.Bottom, vr= 


vizor.Tap, 
vizor.Right; 


double wl=w.Left,wr=w.Right, wt=w.Top,wb=w.Bottom; 
string mes="Fereastra "+wl+" si"+wr+ " cu."+wt+" si" 
/ /MessageBox. Show (mes) ; 


int 
try 
{ 


xe, Ye; 


al=(vl-vr) /(wl-wr) ; 
a2= (vt-vb) / (wb-wt); 
Aiv=(wr-wl)/(vr-vl); 


bl= (wl*vr-wr*vl)/(wl-wr); 
b2= (wb*vb-wt*vt) / (wb-wt) ; 
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xe= (int) (a1*w1+b1);y= PEW); ye = (int) (â2%y+b2); 


for (x=wl; x<wr; x+=div) 

{ 
oldx=xe; oldy=ye; 
xe= (int) (al*x+b1); y=pf (x); ye = (int) (a2*y+b2),; 
e.Graphics.DrawLine(pen,oldx, oldy,xe,ye); 

} 

} 


catch { MessageBox.Show("Eroare in datele de intrare"); 


} 


xe=(int)bi; ye=(int)b2; 

pen=new Pen(brush,3); : 
e.Graphics .DrawLine(pen,vl,ye, vr,ye); // axa Ox 
e.Graphics . DrawLine(pen,xe,vt, xe,vb); // axa Oy 


) 


void MinMax( out double yMin, out double yMax) 
( 
yMin=100.0; yMax=100.0; 
switch(dat.tip_fct) 
{ 
case 1: 
{ 
double yextr,ys,yd,xextr; 
xextr = -dat.B/2/dat.A; yextr = £(xextr) ; 
ys = f(aat.a); ya = f£(dat.b); 


if (xextr >= dat:a && xextr <= Gat.b) 
- // extrem de derivata 
if (dat.A>0) // are minim 
( yMin = yextr; yMax = ys>yd ? ys:yd;} 
else { yMax=yextr; yMin = ys<yd ? ys:yd; }// max 


else // doar extreme de frontiera 


{ yMax = ys > yd ? ys:yă; yMin = ys < yd ? : ; 
PR Y yă ? ys:yd 3} 


) 


case 2: : 
{ yMin = -1.0; yMax = 1.0; ); break; : } 
} // end switch i i 
) 


)// end user graphic context class 
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Se observă că în funcţia de trasare propriu-zisă, deoarece pe contextul 
grafic nu există o funcţie PutPixel, s-a folosit funcția DrawLine. u 

Limitarea reprezentării unei curbe prin pixeli - este legată de 
imposibilitatea determinării extremelor funcției pe caz general.’ Viteza 
redusă de trasare face ca pentru curbele uzuale (dreapta, cerc etc.) să se 
folosescă algoritmi particulari, care speculează simetria curbelor respective. 


a 


Exercitiu 


Să se realizeze o aplicație ce împarte: static fereastra formei în două 
coloane, fiecăreia corespunzandu-i câte:un control de op pane 3i cărora le 
asociază vizualizări distincte: .. . +... : 

* panelului stâng i ‘se asociază. o vizualizare de: tip formular ce 
permite introducerea a patru valori pozitive; 

e vizualizarea din dreapta se foloseşte pentru afișarea grafică a celor 
patru valori. Selectarea tipului de grafic (coloane, linii, pie) se face © 
folosind meniul aplicației. Modificarea culorii folosite pentru 
reprezentarea fiecărei valori se face prin click dreapta pe-TextBox-ul 
corespunzător. : 
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-. 


Rezolvare 


Controlul de tip panel funcționează ca un container pentru celelalte 
controale: 


1. Se crează un proiect Visual CĂ, cu tip aplicație Windows Application. 

2. Se inserează un control de tip panel (ToolBox / Windows Forms / 
Panel ), pe jumătatea stângă a ferestrei formular, proprietatea Layout / 
Dock / Left (controlul de tip panel este lipit de partea stângă a 

. ferestrei aplicaţiei), proprietatea Layout / AutoScroll valoarea True 
(barele de scrol apar automat dacă controalele sunt plasate in afara 
zonei client vizibile a formei), 

3. Se adaugă un control Splitter (ToolBoox / WindowsForms / 
Splitter), lipit de partea dreaptă a controlului de tip panel (se modifică 
proprietatea Layout / Dock în Left), 

4. Se adaugă un nou control de tip Panel (Toolbox/Windows Forms / 
Panel ), care să umple întreaga fereastră formular rămasă, se modifică 
proprietatea Layout / Dock în Fill, 

5. Se adaugă din ToolBox un control de tip MainMeniu: Tip grafic, 
având opţiunile Coloane, Linii, Pie, opţiunea Coloane - selectată 
implicit (proprietatea Misc / Checked valoarea True), 

6. Se adaugă câte o pereche de controale Label şi TextBox pentru cele 

„patru valori, controalele de tip TextBox îşi modifică numele 
(proprietatea Name) în tb_1, tb_2,. 

7. Se adaugă la proiect o nouă Clasă - patie, clasă care va modela 

datele: ClassView /click dreapta / Add / Add Class/ grafic, având: 
e metodele: 

" coloane, linii, pie — corespunzătoare celor trei opțiuni 
de trasare a graficului, prin bare verticale sau orizontale, 
respectiv grafic de structură în cerc; 
puncte — pentru afişarea câte unui x, în fiecare punct de 
„ intersecție a două segmente, în graficul de tip linie, ; 

": Arata — pentru. aftyarea eee corespunzator optiunii 
selectate, 

+7- Maxim -— pentru determinarea valorii maxime; 
e proprietățile (de tip set ) care permit stabilirea valorilor pentru: 
tip (tipul graficului de afişat) şi culori (pentru păstrarea fiecărei 
valori a culorii). 


Textul sursă al clasei grafic: 
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using “System; 


using System. Windows. Forms; 
using System. Drawing; 


namespace splitok 

{ 

public class grafic 
{ 
protected Pen pen; 
protected SolidBrush brush; 
protected double [] v; 
protected double max; 


protected int nrval, tipgr, ddp, 1p; 


protected Rectangle rect, rects; 
protected Point[] pct; 
protected Color [Jcul; - 

public grafic() { } 


public grafic (Double[] val) 
{ 


nrval = val.GetLength (0) ; 
// nr. valori de reprezentat 
v= new Double[nrval]; 


v=val; 
// Pen pentru trasarea curbelor 


pen = new Pen (Color .Black) ; 
// Brush pentru colorarea suprafetelor 


brush= new SolidBrush(Color.White) ; 
} i E 


public înt tip i 

{ set { tipgr = value; } } 
public Color [] culori 

{ set (cul = value;.: } } 


public void Arata(PaintEventArgs e) 


{ 


/* . PaintEventArgs conține: clasa Graphics 


context. */ 
rect=e.ClipRectangle; 


rect. Y¥+=10; 
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rect.X+=10; 
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folosită 
ntru trasarea obiectelor pe dispozitivul de afişare 


pe 

precum şi coordonatele dreptunghiului în care. se va 
desena (stocat de proprietatea ClipRectangle). Un 
obiect de tip Graphics este asociat unui device 


Vizualizări splitate. Elemente de grafică : 


rect.Height-=20; rect.wWidth-=20; 

// Gareptunghiul care va încadra graficul 
e.Graphics .DrawRectangle 

(pen,rect.Left, rect.Top,rect.Width,rect.Height) ; 
switch (tipar) 


{ 
case 1: coloane(e); break; 
case 2: linii(e); break; 
case 3: pie(e); break; 
} 


y 


public void coloane(PaintEventArgs e) 

{ ! : 
lp=(rect.Right-rect.Left)/3/(nrval+1); //latime dreptunghi 
ddp=(rect.Right-lp*nrval) / (nrval+1); 

l // distanța dintre dreptunghiuri 
Maxim ().; 
for (int i=0; i<nrval;i++) 

{ i 
// se defineste un dreptunghi corespunzător valorii i 
rects= new Rectangle( = . 
rect.Left+ddp* (i+1)+lp*i, i 
(int) (rect .Bottom-v[i]* (rect .Bottom-rect.Top) /max) , 
lp, (int) (v[i]* (rect.Bottom-rect.Top) /max) ); 
// Culoare extrasa din vectorul de tip Color 
brush.Color = cul[i]; 
// desenare bara i | ES 
e.Graphics .DrawRectangle (pen, rects); 


-// se colorează dreptunghiul i 
e.Graphics.FillRectangle(brush,rects) ; 


} 


public void linii(PaintEventArgs e) : 
{ 
ddp=rect.Right/(nrval+1); // distanţa dintre 2 puncte 
Maxim(); wa ge 
pet= new Point[nrval]; 
for {int i=0; i<nrval;i++) 
{ : 
pet[i} .X=rect.Left+ddp* (i+1).; 
pet[i] .Y=(int) l 
{rect.Bottom-v[i]* (rect.Bottom-rect.Top) /max) ; 
// se trasează, cate un x 
puncte(pct[i],cul[i],e); 


// se trasează segmentele de dreaptă intre 
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// punctele cu coordonatele în vectorul de 
// structuri de tip Point 
e .Graphics .DrawLines (pen,pct) ; 


public void pie( PaintEventArgs e ) 


{ 
float start=0F; 
/* unghiul, măsurat in grade (in sensul acelor de ceas) 


de la axa OX până la prima latură a feliei de pie */. 
float stop; 
/*unghiul, masurat in grade (in sensul acelor de ceas) 
de la axa OX până la ultima latură a feliei de pie */ 
double sum=0; , | 
for (int i=0; i<nrval;ir+) 

( 

sum += vli]; 


) 


for (int i=0; i<nrval; i++) 
{ i . 
// unghiul e proportional cu valoarea 
stop= (float) (360F*v[i] /sum) ;— E 
// se trasează o felie din pie | 
e Graphics .DrawPie (pen, rect .X, rect.Y,rect.wWidth, 
rect .Height,start, stop ); 
brush.Colorzcul [i); // se colorează felia 
e.Graphics .Fillpie(brush,rect.X,rect.Y,rect Width, 
rect.Height, start, stop ); 
start+=stop; | T 
// unghiul de start al următoarei felii este egal cu 
// cel de stop al celei curente 


} 
} nad i 
public void Maxim () 
{ 
max=v[0];.-.: av tn 
for(int i=1;i<nrval;i++) 


if (max<v[i]) max=vli]; 


} 


7* în punctul de intersecţie. a doua segmente de dreaptă se 
trasează un X, cu culoarea corespunzătoare functiei + / 


public void puncte (Point p, Color c, PaintEventArgs e) 
( a . 


pen.Color=c; 
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e.Graphics .DrawLine (pen,p.X-3,p.Y=3, p.X+3, p.Y+3); 
e.Graphics .DrawLine(pen,p.X+3, p.Y-3, p.X-3,p.Y+3); 
pen.Color=Color.Black; 


În clasa Forml: 


public class Forml : System.Windows.Forms.Form 
{ 
Ma. 

grafic mygr; 

int nrv, men; 

double [] date; 

private System.Windows.Forms.TextBox [] vtb; 
// vector de referinte TextBox-uri 

Color [] csel; 


public Formi () 
{ 
InitializeComponent () ; 
nrv=4; // numărul valorilor 
vtb= new System.Windows.Forms.TextBox[nrv] ; 
vtb[OJ=tb_1; vtblil)=tb_2; vtb[2]=tb_3; vtb[3]=tb_4; 
csel = new Color[nrv]; // vector de culori 
for (int iSo isnirviits) 
{ 
vtb[i].Text="0"; 
csel[i]=vtb[i]. ForeColor; 


men=1; 


8. Se tratează evenimentul Paint al panelului 2: 
Panel2/Events/Appearance / Paint . Acest eveniment este declanşat 
ori de câte ori trebuie retrasat panel2. l 


private void panel2_Paint (object sender, PaintEventArgs e) 

{ 

date =new Double [(nrv]; 

for(int i=0;i<nrv;i++) 

{ i ; 

// preluare date din textBox-uri 
date [i]=Convert .ToDouble (vtb[i].Text); 
) 


// daca s-a introdus cel putin o valoare diferită de zero. 
if ((date[0]!=0) | (âate[1]!=0) | (date[2] !=0) | (date[3]!=0)) 
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( | 
mygr=new grafic(date); // instantiaza obiect grafic 
mygr.tip = men; // tip grafic preluat din meniu 
mygr.culori=csel; // preluare culoare selectata 
mygr.Arata(e); // se trasează graficul 

) 


) 
9. Se tratează evenimentul TextChangea, pentru fiecare din cele patru 


controale de tip TextBox: proprietățile controlului TextBox / 
PropertyChanged / TextChanged 


private void tb_1_TextChanged (object sender, EventArgs e) 
{ ; ; 


_ panel2.Invalidate(true); //generare mesaj Paint 


} 


10. Se tratează evenimentul de redimensionare panel2, prin retrasare 
grafic: Property Changed / sizeChanged: 


private void panel2_SizeChanged (object sender, EventArgs e) 


{ 
Invalidate (true); 


) 


11. Pentru fiecare opţiune a meniului ferestrei formular, se tratează 
evenimentul click (Events/Click). Pentru fiecare dintre opțiunile 
meniului se setează proprietatea Misc/RadioCheck la valoarea true. 
Se setează proprietatea Misc/Checked, pentru fiecare dintre celelalte 
opţiuni ale meniului la valoarea false, iar opțiunea selectată ia 
valoarea true. Variabila. men primeşte valoarea 1, 2 sau 3, în funcție 
de opţiunea selectată din meniu. 


private void menuItem2_Click (object sender, EventArgs e) 
Co phe : 
i _ Menultem item = (Menuitem) sender; ` 
ze fi i ‘yyitemul selectat al meniulűi 
Menu parens = item.Parent; 
// părintele item- wui curent 
if K item != null ) 
{ 
SOL eee: ( MenuItem mi in parent.MenuItems ) 
mi.Checked = false; 
item.Checked = true; 
} 
men=item. Index+1; 
panel2 .Invalidate (true); 
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12. Din ToolBoox/WindowsForms “se inserează un control de tip 
ColorDialog; se redenumeste cu cd; 
13. Pentru fiecare control TextBox se tratează evenimentul de click 


dreapta mouse, astfel: pe controlul tb_1 /Events 
/Mouse/MouseDown, se introduce textul sursă: 


private void tb_1_MouseDown (object sender; MouseEventArgs e) 
{ + tm Ss oom 
if (e.Button==MouseButtons.Right) 

// butonul dreapta mouse apăsat 
{ l ` : 
cd.ShowDialog(); // afişare ColorDialog 
csel[0]=câ.Color; // se preaia culoarea selectată 
tb_1.Forecolor=csel[0]; // colorează TextBox 
panel2 .Invalidate (true); 
) 


Exercitiu. 


Să se construiască un ComboBox cu DrawMode de tip 
ownerDrawvariable care să afişeze ‘fonturile“* din sistem A 
pontFami 1y .Fami Lies ) scrise cu propriu fontul. In acest sens, preluăm din 
argumentele evenimentului, DrawItem e.Graphics şi scriem itemul cu 


Drawstring 
9 Exercitiu. 


Să se construiască un ComboBox pentru alegerea unei culori, în care 
numele fiecărei culori este scris în culoarea respectivă. 


MouseEventargs specifică butonul mouse-ului care a fost apăsat, de <a i" 
câte ori a fost apăsat, coordonatele mouse-ului la click şi cu cât s-a mişcat - k ” te Se pe nan Sa 
rotita mouse-ului. i oe : di oi: ui ERER 

Proprietatea Button a variabilei e (de tip MouseEventArgs) indică 
butonul apăsat. i 

Enumerarea MouseButtons conţine constantele care definesc butonul 
care a fost apăsat. ie: 
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= UCRU CU CLIPBOARD-UL. OPERATIADE DRAG 


AND DROP 


1. Clipboard-ul 
2. Operatia de drag and drop. 
3. Drag and drop pe tipuri definite de programator 


1. Clipboard-ul 


Transferul prin clipboard presupune ca obiectele să ştie să se transforme 
în mai multe formate pentru a se adapta la capacitățile de înțelegere ale 
aplicaţiei ce-l va prelua din clipboard. 

Pe de altă parte, şi aplicația care face Paste, când este scrisă. de 
programator, poate fi şi ea instruită să recunoască diferite formate de 
obiecte. "Obiectele, de orice tip ar fi, se depun in clipboard printr-un apel 
Clipboară. SetDataobject () , ca de exemplu: 


Clipboard. setData0object : | 
("Text pus in Clipboard prin program"); 


Sau: 
Bitmap img = new. Bitmap("sunset.jpg"); 
Clipboard.SetDataObject (img); 


Transferul de date în Windows Forms este permis pentru clasele care 
implementează interfaţa IDataObject; acest lucru face ca toate obiectele să 
aibă o parte constituită din metodele de interfață standard moştenite, iar pe 
de altă parte programatorul să poată gestiona orice obiect prin referință la 
interfața de bază moştenită. 

Aplicația care foloseşte obiectele puse în clipboard cere mai întâi o 


referință la “subobiectul” IDataObject, invocând pentru aceasta metoda 
Clipboard.GetDataobject (): 


IDataObject o = Clipboard.GetDataObject (); 


Dispunând de referința la această interfață, aplicația se poate interesa 
acum dacă cea ce există la un moment dat în clipboard este de un anume tip 
de obiect sau se poate converti într-un anume tip; pentru aceasta, invocă 
metoda GetDataPresent( ), căreia îi furnizează ca parametru tipul 
căutat : 
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bool vb = o.GetDataPresent-(.typeof (Bitmap)); 


“iar metoda răspunde afirmativ sau nu. În acest fel, aplicația consumatoare îşi 


extrage din clipboard doar obiectele pe care le recunoaşte ca tip sau acestea 
sunt capabile să se transforme într-un format acceptat de aplicația 
consumatoare. 

Nu trebuie uitat că sub .NET orice obiect derivat din object știe să se 
transforme în string (metoda ToString() ) şi că în ultimă instanță am 
găsi ceva de pus ca răspuns la comanda de ‘Paste, dacă acest lucru ne 
satisface. Pe de altă parte, nu ştim cine a încărcat clipboard-ul și deci pot 
exista acolo si obiecte ce nu există în .NET. 

Dacă  interogând interfața  IDataObject, _ printr-un apel 
GetDataPresent( typeof(tip_dorit) ), implementată într-o forma 
specifică şi de obiectul aflat în Clipboard, ni se răspunde afirmativ cu 
privire la existența acelui tip, se poate lansa o cerere de extragere sau 
conversie a obiectului din clipboard, folosind metoda cetData( ) . 


if (o.GetDataPresent (typeof (Bitmap) )) 


{ 
Bitmap img = (Bitmap)o. GetData (typeof (Bitmap) ); 


g- DrawImage (img, panell. ClientRectangle) ; 


Exercitiu 
Să se'scrie un exemplu în care’ prin două butoane inscripționate "Pune 


text in Clipboard" și "Pune bmp in Clipboard" se încarcă prin 
program clipboard-ul cu un text sau cu 0 imagine. bs 2 ist 

Prin intermediul altui buton, inscripționat "Scoate din 
Clipboard", conținutul clipboard- -ului este descărcat într-un panel aflat pe 
forma principală a aplicaţiei. 


Rezolvare 


Se aduc din ToolBox cale trei butoane şi panelul, punându-li-se 
proprietăţi adecvate. Programul ar putea arăta astfel : 


using System; 
using System.Drawing; 
using System.Windows.Forms; 


class Test :.Form 


£ 
private System. Windows .Forms .Button bl; 
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private System.Windows.Forms.Button. b2; 
private System.Windows.Forms.Button b3; 
prate System. Windows. Forms.Panel paneli; 


- Lucru cu clipboard-ul. Operația de drag and drop | 


this.bl.Location = new System.Drawing.Point(8, 72); 
this.bl.Name = "bl"; 
this.b1.Size = new System. Drawing.Size(128, 23); 


Test() - this.b1.TabIndex = 0; 
{ this.b1.Text = "Pune text in Clipboard"; 
InitializeComponent (); this.b1.Click += new System. EventHandler (this. PuneText) ; 
) i // 
A a | «i // b2 
public void PuneText (Object s, EventArgs a) // 


this.b2.Location = new System. Drawing. Point (424, 128); 
this.b2.Name = "b2"; 
this.b2.Size = new System.Drawing.Size(120, 23); 


{ 
‘Clipboard. SetDataobject 
("Text pus in Clipboard prin program"); 


} this.b2.TabIndex = 1; 
. : this.b2.Text = "Scoate din Clipboard"; 
private void PuneBmp(object sender, System.EventArgs e) this.b2.Click += new System.EventHandler (this.Scoate) ; 
{ : : // : 
Bitmap img=new Bitmap("sunset.jpg"); // panell 
// 


. Clipboard. SetDataobject (img); 
- this.panell.BackColor = System.Drawing.Color.FromArgb ( 
({System.Byte) (255)), 
( (System. Byte) (255)), ` 


public void Scoate(Object s, EventArgs a) ( (System. Byte) (192))); 


{ : this.panell.Location = new System.Drawing. Point (144, 0); 
Graphics g = Graphics.FromHwnd(paneli.Handle); this.panell.Name = "panell"; A: 
IDataObject o = Clipboarâd.GetDataobject (); this.paneli.Size = new a ch Drawing. Size(272, 272); 

- i this.panel1.Tablndex = 2; 
if (o.GetDataPresent (typeof (string))) // . 
E i // b3 
., g-DrawString(o.GetData (typeof (string) ) .ToString(), Tf 
it „Font, new SolidBrush(Color.Black),10,10 ); - this.b3.Location = new System. Drawing. Point (8, 184); 
Jo : ` i this.b3.Name. = "b3"; ' 
else if(o.GetDatabresent (typeof (Bitmap) ) ) this.b3.Size = new System. Drawing. Size (128, 23); 
{ ý . i this.b3.TabIndex = 3; ` i 
Bitmap img = (Bitmap)o.GetData (typeof (Bitmap)); this.b3.Text = "Pune bmp in clipboard"; i 
i g-DrawImage (img, panel1.ClientRectangle) ; this.b3.Click += new st Csi Pventiandker (Ehia; PuneBinp) ; 
else MessageBox. Show a Test 
( "Format obiect din Clipboard nerecunoscut"); // i i 
„) i this.AutoScaleBaseSize = new System.Drawing. Size(5, 13); 


this.ClientSize = new System. Drawing. Size (560, 273); 
this.Controls.Add(this.b3); 
‘this.Controls.Add(this.panel1) ; 
this.Controls.Add(this.b2);_ 
this.Controls.Add(this.bi); 


private void InitializeComponent () 
{ i l f 
this.bl = new System.Windows.Forms.Button(); 
this.b2 = new System.Windows.Forms.Button(); 


this.panell = new System.Windows .Forms.Panel({); this.Name = "Test"; 
this.b3 = new System.Windows.Forms.Button(); this .ResumeLayout (false); 
this . SuspendLayout (); ) 
/f 
7 b1 public static void Main() 
{ 
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Application.Run(new Test());: 


Existenţa celor două butoane pentru a încărca prin program clipboard- 
ul cu ceva, nu exclude posibilitatea preluării în clipboard a unor obiecte prin 
intermediul altei aplicaţii ; spre exemplu, din Word se pot prelua texte sau 
imagini ( bmp sau ico ) cu Copy, urmând ca în aplicația noastră să se apese 
doar pe butonul de scos din clipboard. În cazul în care clipboard-ul 
conține obiecte de tip necunoscut şi care nici nu ştiu să se convertească într- 
un tip recunoscut de aplicaţia noastră, se va afişa un mesaj în acest sens ( 
spre exemplu, preluaţi cu Copy un control din Designer şi încercaţi să faceţi 
Paste în aplicația de mai sus ). 

Invers, imaginea sau textul puse în clipboard prin apăsarea butoanelor 
aplicației pot fi inserate cu Paste într-un document Word sau într-o altă 
aplicație care înțelege aceste formate. 

Chiar dacă obiectul din clipboard este de un tip acceptat de aplicaţia 
consumatoare, la apelul cetData este necesară şi aplicarea unui cast, 
valorii returnate de funcția de extragere. 


2. Operația de drag and drop 


Iniţierea operației de drag & drop se poate face de pe orice eveniment, 
însă uzual ea se sincronizează cu evenimentul MouseDown, deoarece acesta 
furnizeaza informatii detaliate despre poziția mouse-ului: Iniţierea propriu- 
zisă se face printr-un apel DoDragDrop, recunoscută de multe controale. În 
acest moment se stabilesc datele ce fac obiectul dragării, precum şi 
drepturile acordate de sursă asupra datelor: copiere sau mutare. 
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Următorul eveniment ce intervine în operaţia de drag & drop este 
DragEnter, declanşat la intrarea în regiunea unui control care permite 
droping (proprietatea AllowDrop este true). Cu acest prilej se consultă 
drepturile permise de această posibilă destinație şi acestea sunt confruntate 
cu cele acordate de sursă, determinându-se efectul final pentru drop. 

Cel de-al treilea eveniment, DragDrop se generează în momentul 
relaxării mouse-ului în timpul derulăriiunei operaţii de dragare. Cu acest 
prilej, se furnizează codul care materializează efectul operației. l 

` Obiectul transmis ca parametru în funcțiile de tratare a evenimentelor 
implicate ( blocul de argumente ) tine şi datele implicate în operaţia de drag 
& drop 

Unele controale recunosc chiar evenimente specifice legate de 
operaţia drag & drop; de exemplu, ListView şi TreeView au evenimentul 
ItemDrag. 


Exercitiu. Să se încarce un TextBox preluând prin drag and drop, textul 
înscris pe un buton. 


1. Se crează o aplicație formular; 

2. se aduc din ToolBox un buton şi un textbox ;. 

3. se marchează textbox-ul ca acceptând drop ( Properties / 

AllowDrop pe true); 

4. se initiază operaţia de drag & drop pe evenimentul MouseDown de 
buton, moment în care printr-un apel DoDragDrop se fixează sursa de 
date.ce face obiectul dragării ( textul înscris pe buton) şi efectele 
permise pentru destinaţie (Copy sau Move). | | 
Observaţie: 

DoDragDrop este o metodă de-a controlului sursă ( butonul, 
în cazul nostru)! -,, 


i private void button1_MouseDown (obj ect sender, | 
aaar Ka System. Windows . Forms .MouseEventArgs e) 
{ l Pe ke 
button1.DoDragDrop (buttoni. Text, 
DragDropEffects.Copy | DragDropEffects.Move |; 


) 


5. la intrarea mouse-lui pe suprafața textbox-ului (evenimentul 
DragEnter ) se testează compatibilitatea formatului datelor dragate 
-cu formatul destinaţiei posibile. În caz de neconcordanta se pot face 
conversii pe acest eveniment sau pur şi simplu se forteza efectul 
None, în loc de copy sau Move. 
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private void textBox1l_DragEnter (object sender, 
System.Windows.Forms.DragEventArgs e) 


{ 
if (e.Data.GetDataPresent (DataFormats.Text) ) 


e.Effect = DragDropEffects.Copy; 
else 


e.Effect = DragDropEffects.None; 


6. textbox-ul acceptă drop, schimbându-și astfel textul prin preluarea 


celui indicat prin argumentul funcţiei de tratare a evenimentului 
DragDrop: 


private void textBox1_DragDrop (object sender, 
System.Windows.Forms.DragEventArgs e) 


{ 
textBoxl.Text = 


e.Data.GetData(DataFormats.Text) .ToString(); 


Se pot transfera date incapsulate foarte variate, spre exemplu chiar 
cod sursă necesar regăsirii datelor într-un DataSet. | 

Pe pragEnter Sau Dragover se stabileşte si efectul (acţiunea) care 
se va aplica la drop în acest caz, unul dintre cele fixate inițial de către sursă, 
la apelul DopragDrop. Efectele permise de sursă pot fi consultate acum prin 
proprietatea : e.AllowedEffect numai că sunt stocate pe biți, 
corespunzători; spre exemplu expresia  a.AlloweăEffect & 
DragDropEffects.Copy izolează: bitul aferent efectului de copy, bit ce 
poate fi testat comparându-l cu constantele posibile :(- în cazul nostru 
DragDropEffects . Copy. "o ai 

Efectul de executat se poate stabili dinamic si în functie de starea 
combinată a altor taste ( CTRL, SHIFT, ALT ) sau a butoanelor mouse-ului. 
Proprietatea e.KeyState tine câte un bit de stare pentru fiecare tastă sau 
buton de mouse, putând indica prezența cumulativă a mai multor taste 
apăsate; valorile individuale asociate sunt indicate mai jos. - 


buton mijloc mouse 
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Dacă în funcţia textBox1_DragEnter de mai sus schimbăm codul 
astfel: 


private void textBox1_DragEnter (object sender, 
system. Windows . Forms . DragEventArgs e) 


{ 
e.Effect = DragDropEffects.None; : 


// implicit, nimic fara permisiune 


== bitul CTRL este setat 
if. ((e.KeyState & 8) == 8 && // : e 
i : AllowedEffect & DragDropEffects.Copy) == // izolare 
A DragDropEf fects .Copy) 

// are si permisiune (bitul) Copy 
e.Effect = DragDropEffects.Copy; // face Copy 
else i oe 

if ((e.AllowedEffect & DragDropEffects.Move) == 
DragDropEf fects .Move) 


// altfel Move, daca bitul Move permis 
e.Effect = DragDropEf fects .Move; 
3 l d i . . ~ . “A 

atunci prin apăsare CTRL se indică drept efect copierea textului în TextBox 

(textul rămâne şi pe buton ). De remarcat că deoarece tratarea s-a făcut pe 

evenimentul DragEnter şi nu Dragover, tastă CTRL trebuie să fie apasată 

înainte de intrarea cu mouse-ul în regiunea butonului, altfel efectul nu mai 

poate fi schimbat, rămânând activ cel de Move. _ 

În funcţia textBoxl_DragDrop Se stabileşte. în clar în ce constă 

actiunea asociată cu drop, având grijă ca în cazul efectului Move sa anulăm 
şi textul de pe buton: 


textBox1.Text = e.Data.GetData (Dataformats. Text) .ToString(); 
if (e. Effect==DragDropEffects.Move) 
puttoni.Text =." - so ACE 


t 


Drag & drop între aplicații se execută după aceleaşi reguli; fără a 

` modifica” nimic în codul programului, la rulare redimensionam ferestrele 
Visual Studio si cea a aplicatiei, incat să fie vizibile ambele simultan. Facem 

o dra gare de text din editorul de text Visual Studio în textbox-ul aplicației şi 
vedem că se execută în aceeaşi manieră ca şi cum am lucra în interiorul unei ‘ 


aplicaţii. 
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3. Drag and drop pe tipuri definite de programator 


Ca şi transferul prin clipboard-ul, facilitatea de drag and drop se 
bazează în „NET tot pe interfaţa IDataObject si realizează o formă as 14 
vizuala de transfer al obiectelor, între aplicaţii sau între EI A 
aceleeaşi aplicații. Ca urmare, fie se transferă obiecte uzuale de tipul 
String, Image etc., fie se definesc clase care implementează interfața 
IDataObject, prin care obiectele sunt învățate: cum să se transforme şi î 
alte tipuri, recunoscute și acceptate de alte aplicaţii. i A si 


Exercitiu 


: Sa se defineasca o clasă Pers capabilă să suporte drag and drop, avînd 
ca destinații posibile aplicatii sau componente care acceptă tipurile Bitmap 
String, ListViewItem Sau PrintDocument. i 
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Rezolvare 


R Clasa zi să fie derivată din IDataObject şi va conţine câteva 
campuri membre printre care şi numele unui fisi i ; 
i ui fişier ce conține poza i 
respective.. - ree : : wear 
public class Pers:IDataObject. 
oot . 
77 Aici se introduc metodele interfeței IDataobjest 


public int Marca; 
public string Numa; 
string fisImagine; 


public Pers(int m, string n, string fisImg) 
{Marca=m; Nume=n; fisImagine=fisImg; } 7 
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Implementarea interfeţei IDataObject de către o clasă de utilizator 


trebuie să rezolve patru probleme: 


1. să expună formatele suportate de clasă; 
2. să încarce datele furnizate de clasă ; 


3. să dea răspunsul la întrebarea dacă obiectul se poate transforma 
sau nu într-un format anume, cerut de o aplicaţie client; 


4. să extragă datele în formatul adecvat fiecărei aplicaţii client. 


Ca urmare vor trebuie adăugate clasei Pers metodele specifice de 
implementare a interfeţei. IDataObject, care să rezolve toate aceste 


probleme. 
1. Expunerea formatelor suportate de clasă 


La prima problemă, răspunsul îl dă scrierea supraîncărcărilor funcţiei 


' GetFormats(). Acestea retumează un vector de formate în care un 


DataObject este disponibil, deci numele claselor .NET în care datele 
conţinute de obiect pot fi convertite. În acest sens, clasa pers va conţine 
două versiuni ale funcției GetFormats( ). . 

Prima versiune returnează doar tipurile native în care ea se poate 
converti; aceste tipuri pot fi clase .NET, alte clase introduse de utilizator sau 
interfețe din care e derivată clasa şi reprezintă formatele în care data este 


stocată : 


public string[] GetFormats () 
{ 


return new string {} 
{ "Pers", "Bitmap", "listViewItem" ); 


} 


Cea de-a doua versiune primeşte un parametru de intrare de tip bool, 
indicând dacă utilizatorul doreşte sau nu şi tipuri alternative, altele decât 
cele native, în care obiectul dragat s-ar putea converti dacă tipul solicitat nu 
este disponibil; autoconvert pe false foloseşte când dorim să nu 
permitem o anumită conversie de adaptare (- spre exemplu, tipul 
UnicodeText stocat s-ar putea la rândul lui converti la nevoie în Text sau în 
String ), ci să folosim doar formatele native. 


public string[] GetFormats (bool autoConvert) 


{ 


if (autoConvert) // toate formatele 
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return new string[] | 
( "Pers", "Bitmap", "ListViewItem", DataFormats.Text }; 


// total tipuri: native + generale 
else i 


return GetFormats();// doar cele native 


2. Încărcarea datelor furnizate de clasă 


Se face prin versiunile supraîncărcate ale funcţiei setData; prima 
este varianta de bază şi încarcă pur şi simplu o referință la obiectul dragat. 


object obiectul; // referinta obiectului de transferat 


public void SetData (object o) 
{ 
if (o is Pers) (obiectul = (Pers) o;} 
// obiectul propriu-zis 


Următoarele două versiuni cer stocarea într-un anumit format, acesta i 
fiind indicat ca prim parametru de apel, fie prin Senimi; fie ca tip 
recunoscut sub .NET : 


//- SetData pentru tipurile native 
public void SetData(string fmt, object o) 


{ . 
switch(fmt) 
{ . 
case "Pers": SetData(o);break; 
case "ListViewItem": | SetData (o) ; break; 
case "Bitmap": SetData (o) ;break; 
case "Text": 
obiectul = new Pers(0,"xxx","");break; 
default: MessageBox. Show. o 
("Nu se poate converti in "+fmt);break; 
) 
) į 


// sa mearga si sub forma: in ce tip, care obiect 
public void SetData(Type t, object o) . i 
{ SetData(t.Name, o); | } 


După cum se vede, ultimele două versiuni fac apel, direct. sau 
indirect, tot la forma de bază. 
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O altă versiune permite setarea obiectului într-un format depinzând 
de un al treilea parametru, cel de autoconvert, cu semnificația explicată mai 
sus, la funcția GetFormats( ). 


public void SetData(String fmt, bool convert, object o) 
// supraincarcare cu autoconvert 


{ 
if (fmt == DataFormats.Text&& convert == false ) | 
// doar formatele stocate 
{ 
MessageBox. Show 
("Refuz prin parametru sa convertesc in “+fmt); 
} 
else 
//chiar si in formate in care stie sa se autotransforme 
{ j 
SetData(fmt, o); 
) i 
) 


Dacă se doreşte stocarea datelor în mai multe formate se invocă de mai 
multe ori SetData cu aceeaşi instanță de [DataObject ; 


3. Răspunsul la întrebarea dacă obiectul se poate sau nu 
transforma într-un format anume, dorit de o aplicaţie client 


Este furnizat de apelul uneia din versiunile funcţiei cetDataPresent () : 


public bool GetDataPresent (string fmt) 


{ x \ ‘i 
if (fmt == "Pers" || fmt == "Bitmap" 
= || fmt == "ListViewItem" 
|| fmt == DataFormats. Text) 
return true; 
else 
return false; 
} 


public bool GetDataPresent (Type t) 
{ //.acelasi lucru, dar cu tip dat ca parametrul 
return (GetDataPresent (t.Name) ); 
} // xredirecteaza la cea de mai sus 


// acelasi, dar si cu optiune de autoconvert 
publi bool GetDataPresent (String fmt, bool convert) 


{ 


if (fmt == DataFormats.Text && convert == false) 
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// variantele stocate, fara conversie in alte tipuri 
return false; 
else i 
` // cu posibile conversii in alte tipuri 
return GetDataPresent (fmt); 


3 Lucru cu clipboard-ul. Operația de drag and drop 


Elemente Brees" ures in cadrul aplicației 
UȘI 


în sivas Forml se PE colecţiile de persoane, de PictureBox ȘI o ) listă de 
imagini. 


public ArrayList persColect; i ab og 
public ArrayList pictcolect; 

public Pers [] vp; ` ~ 

public PictureBox DI vi; 

ImageList li; i 4 tee tă dca. Gh Sty 


Se observă că interogarea se poate face dând denumirea formatului ca 
String, sau tipul obiectului, făcând sau nu distincție între formatele de 
stocare si cele obţinute prin conversii suplimentare. 


_ S-a preferat încărcarea colecţiilor de persoane şi. de imagini prin 
preluarea elementelor din vectorii vp, respectiv vi.. S- “au, ales colecţii î in 
locul vectorilor pentru a putea elimina elemente pe măsura dragării unor 
iconuri în Recycle Bin. : 

in constructorul clasei Forml au fost încărcate toate. aceste » colecţii: 
public Fornl () 
{ 


4. Extragerea datelor în formatul adecvat fiecărei aplicații 
client 


Extragerea datelor se face printr-un apel GetData(); să ne reamintim că 
instanțe ale clasei DataObject care mediază transferul prin drag and drop, 
sunt stocate în diverse formate la o referință gestionată printr-o referintă de 
object generic, denumită de noi obiectul. Conversia se poate face aşadar la 
sursă ( înainte de încărcarea referintei prin SetData) sau la destinaţie, la 
momentul extragerii obiectului prin GetData( ). Versiunea propusă aici 


InitializeComponent () ; 
vp = new Pers] . 
{ : Ri a W gE yet ee T D 


pentru GetData() face conversii la destinație pentru toate formatele. 
new Pers(0, "Zero ","fis0.bmp"), 
public object GetData (string fmt) new Pers(1,"Unu “","fisl.bmp") zi enf 
{ new Pers(2,"Doi ","“fis2.bmp"), 
switch (fmt) new Pers(3,"Trei","fis3.bmp"), 
{~ new Pers (4, "Patru", "fis4.bmp"), 
case "Bitmap" . | A new Pers(5, "Cinci", "fis5.bmp") 
return new Bitmap( ((Pers)obiectul).fisImagine );.. Mag Oe site i 


a : : persColect = new ArrayList(vp); 
case, "ListViewItem" :// conversie la destinatie i 


ListViewItem itm = vi = new PictureBox[] 


new ListViewItem(""+((Pers) obiectul) .Marca,1); { 
itm.SubItems.Add(( (Pers) obiectul) .Nume) ; pictureBox3,pictureBox4,pictureBox5, 
“return itm; Bie fa tt gta PLEN REGIA pictureBox8.: SE mon AE 
Ae A e Peay rd ee ratie 


case "Pers" : // nu necesita conversie pictColect=new ArrayList (vi) ; : dhe ena beng 


return obiectul; 
li=new ImageList (); 


li.Images.Add( new Icon("pers0.ico") 
li.Images.Add( new Icon("persl.ico") 


case "Text" : // conversie la destinatie ) 
) 
li.Images.Add( new Icon("pers2.ico")* ); 
) 
) 
) 


return NRE EREREEKKEEEEKEKERY OV 
((Pers)obiectul) .Marca+ " " 


+( (Pers) obiectul) .Nume+ 
NYANE RRR RARER KER KR KK n = 
; 


li.Images.Add( new Icon("pers3.ico") 
li.Images.Add( new Icon("pers4.ico") 
default li.Images.Add{ new Icon("persS.ico") 
MessageBox. Show(“Ar putea fi, dar nu e inca "“+imt) ; | 


return null; 
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Din punct de vedere vizual, au fost construite pe formă:;. 

e un panel central ce conţine iconurile asupra ci cărora se execută operația dé 
- drag and drop; 

e un control ListView, în decane ce va prelua informatiile prin dragarea 
iconurilor; drept cap de tabel, lista va afişa marca Şi nimele şi 
prenumele fiecărei persoane; 

e un panel, în stânga, ce va permite vizualizarea bitmap- -urilor (pozelor) 
persoanelor; 

e două paneluri, în partea de jos, ce conțin imaginile unei imprimante şi a 

„unui Recycle Bin şi permit implementarea prin acţiunea de drop, a 

previzualizării unui document cu cartea de vizită a unei persoane, 
respectiv, eliminarea unei persoane din colectie. 


Direc ce va conține fişierul executabil al aplicaţiei a 1 fost populat cu 


cîteva fişiere denumite persnn.ico, respectiv fisnn.bimp, ce conțin icon-uri 
sugerând persoane şi imagini bmp ale unor persoane, câte un fişier din 
fiecare categorie pentru fiecare persoană din colec 


Încărcarea iconurilor s-a făcut printr-o funcție speciali cală. 


public void Incarcalconuri () 

{ 
int poz=0; $ 
foreach (Image i in ii. Tags), 


{ 
PictureBox = = (PictureBox) pictcolect [poz] ; 
pb.Image=li .Images[poz];:: 
poz++; 


} 


apelata atat la repictarea. formei, cât şi la modificări aduse colecţiei de 
iconuri; la repictarea formei se adaugă peste paneluri si celelalte imagini, 
preluate din fişiere aflate tot în directorul curent al aplicației: - 


private void Form1_Paint (object sender, PaintEventArgs e) 
{ one i i E Ta 
Graphics g = panel3.CreateGraphics (); 
Bitmap cosul= new Bitmap("Cosul.bmp") ; 
g.DrawImage (cosul, panel3.ClientRectangle) ; 


g = panel4.CreateGraphics(); 


Bitmap imprimanta= new Bitmap("imprimanta.bmp"); 
g.DrawImage (imprimanta, panel4.ClientRectangle) ; 
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Thi 7 n ne djinn Pain 


IncarcalIconuri (); 


) 
Iniţierea operației de drag and drop 


Se poate face pe evenimentul MouseDown asociat panelui cu iconuri. 


` Cu acest prilej se stochează datele in diverse formate, folosind o instanță 


fictivă a clasei Pers. Deşi nu se fac aici conversii, stocându-se de fapt de 
fiecare dată tot un obiect de tip Pers, apelurile repetate ale funcției au 
menirea să înregistreze existenţa diverselor tipuri de stocare. 


private void MouseDownIconurd (object s, : MouseEventArgs e) 
{ // initiere d&d : 


Pers persSursa=new Pers (0, "Pictiv",""); 
int poz= pictColect. IndexO£ | (PictureBox) s ); 
‘if (poz>- 1 && „poz <persColect. Count) | 


{ 


// cate un SetData pt fiecare tip, pe acelasi obiect!! © 
persSursa. SetData (persColect[poz]); 
perssursa: SetData("Text", persColect[poz]}; 


persSursa. Setpata ("ListViewItem", persColect [poz] ) ; 
persSursa. SetData (*Bitmap* ,persColect [poz]) ; 


((Control). s).DoDragDrop -.:..- 
( persSursa, Dio opac Goo peavor Saberects: Move ); 
// controlul permite Bees de ‘Copy sau Move (autoteflexie) 


} 


Tratarea evenimentului de drag and drop la nivelul destinatiei 
Obiectele destinaţie trebuie să aibă proprietatea AllowDrop pe. true. 
Pentru fiecare din posibilele destinaţii care acceptă drag and. drop, se scrie 
câte o pereche de funcții: 
e xxx_DragEnter, în care se testează dacă obiectul dragat scent 
“unul din formatele recunoscute şi de obiectul deasupra căruia se află, 
"moment în care se decide asupra efectului de urmat, None in cazul 


inconipatibilităţii de formate. 
e xxx_DragDrop; în care se materializează Seu dorit P drop. 


Pentru controlul ListView, cele două Meot sunt 
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private void TistViewl_DragEnter 
(object sender, System.Windows.Forms.DragEventArgs e) 


{ 
if (e.Data.GetDataPresent ("ListViewItem")  ) 
e.Effect = DragDropEffects.Copy; 
else 
BEN =x @.Effect = .DragDropEffects.None; 
i}: Pao oo 


an 
i i 


private void listViewl_DragDrop i 
(object ‘sender, System.Windows.Forms.DragEventArgs e) 


{ 
listViewl1. Items. Add ( i 


(ListViewItem) e.Data.GetData("ListViewItem") ); 
} 


Pentru panelul ce conține un: bitmap asociat fiecărei persoane, 
funcţia de drop face extragerea obiectului în format Bitmap şi vizualizează 
imaginea. A l 


private void panel2_DragEnter of 
(object sender, System.Windows.Forms.DragEventArgs e) 


{ : a AR E ze 
if (e.Data.GetDataPresent ("Bitmap") ) 
zu stii e.Effect = DragDropEffects.Copy; 
else 
e.Effect = DragDropEffects.None;. 


) : Pe eee ee i a £ 


-r E E 3 


// drop genereaza bitmap 
private void panel2_DragDrop 
(object.sender, .System.Windows.Forms.DragEventArgs. e) 


{ s 
Graphics g = panel2.CreateGraphics (); 
Bitmap`b= (Bitmap) e.Data.GetData ("Bitmap"); 
a g-DrawImage (b, panel2-ClientRectangle) ;. 
) = 


„. Pentru panelul ce.semnifică. trimiterea unui icon în Recycle Bin, 
funcţia de drop extrage obiectul dragat, îi identifică poziţia în colecţia de 
persoane, după care luând ca reper această colecţie operează eliminările 
poziţiei respective din colecția de persoane şi din lista de iconuri, iar în 
colecţia de PictureBox-uri, o face pe ultima invizibilă şi redistribuie prin 
reîncărcarea pe primele locuri, imaginile rămase. 


private void panel3_DragEnter 
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(object sender, System. Windows .Foxms .DeagEventArgs e) 


í ai i n 
if (e.Data.GetDataPresent ("Pers ») ) 
e.Effect.= DragDropEffects.Move; 
else 
e.Effect = DragDropEffects.None; 
} 


// arunca la cos 0 OTS 
rivate void panel3_DragDrop | 
i (object sender, System. Windows . Forms . DragEventArgs e) 


{ oo 
Pers p = (Pers)e.Data.GetData ("Pers ).; 


int poz =persColect. Indexof (p); - 
// persColect este reperul pt toate colectiile 


persColect.RemoveAt (poz); // scot persoana 


//ultimul box devine invizibil; l o 

( (PictureBox) pictColect [persColect .Count]) .Visible=false; 
1i . Images .RemoveAt (poz) i // scot iconul din lista 
Incarcalconuri(); // reincarca icon-urile 


3 


Dragarea peste panelul ce afişează o imprimantă este interpretată ca 
o cerere de previzualizare a cărţii de vizită a persoanei dragate. In acest 
sens, functia de tratare va extrage obiectul sub forma de text, îl va stoca într- 
o variabilă alocată la nivelul formei, după care va instanfia un 
printDocument şi un PrintPreviewDialog, şi va face legătura între ele 
declarând documentul ca proprietate a dialogului. de „previzualizare. 
Imprimarea propriu-zisă O face o funcţie (prtDoc_PrintPage) de tratare a 


evenimentului PrintPage, declanşât automat odată cu activarea, dialogului 
de previzualizare. ai a 


private void panel4_DragEnter (object sender, . : ia ȘI 
System. Windows . Forms . DragEventArgs ey pie 


: = ae ayo 
if (e.Data.GetDataPresent ("Pers oe eer 
e.Effect = DragDropEffects.Copy; 
else ; 
e.Effect = DragDropEffects.None; 
) i 


ŢI drop genereaza preview 
private void panel4_DragDrop (object sender, 
System. Windows . Forms . DragEventArgs e) 


{ 
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txt=(String)e.Data.GetData ("Text"); 

PrintPreviewDialog prevDial=new PrintPreviewDialog(); 

System. Drawing. Printing. PrintDocument prtDoc; 

prtDoc = new System. Drawing. Printing. PrintDocument () ; 

prtDoc.PrintPage += new 

System. Drawing. Printing. Print PageEventHandler 

(prtDoc_PrintPage) ; 

prevDial.Document=prtDoc; 

prevDial.ShowDialog(); 

panel2.Refresh(); 

} ri 


private void prtDoc_PrintPage (object sender, 
system. Drawing.Printing. PrintPageEventArgs e) 
{ F 
e.Graphics.DrawString (txt, new Font ("Arial",12), 
new SolidBrush(Color.Red),10,10 ); 
// txt membru al formei, contine textul de afisat 


Se poate testa făcând dragarea unui icon peste un document MS 
Word, observându-se că documentul va afişa obiectul pers în format text. 

Invers, preluând prin dragare o imagine bitmap dintr-un document 
Word. şi lăsând-o peste panelul ce afişează bitmap-uri, acesta va reda 
imaginea dragată, confirmându-ne  generalitatea . standardului de 
implementare a interfetei IDataObject. i 
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LEGAREA DATELOR DE INTERFATA UTILIZATOR. 
o= DATA BINDING ` 


1. Legarea simplă — sple data binding 
2. Legarea complexă- complex data binding 


"1. Legarea simplă — simple data binding 


De multe ori avem nevoie ca datele afişate de unele controale să 
reflecte valori ale unor variabile din program; spre exemplu, ne-ar interesa 
ca un TextBox să afişeze: valoarea unei variabile şi setând textul în control 
să modificăm şi valoarea variabilei. Invers, dintr-o prelucrare rezultă o 
valoare modificătă pentru variabilă şi este firesc TextBox-ul să afişeze noua 
valoare. Apare deci normală nevoia declarării unor astfel de legături, pentru 
a se putea alinia ambii membri ai legăturii, la modificârea unuia dintre ei. 
Legarea datelor presupune în acelaşi timp şi conversie automată, adică o 
legătură între reprezentarea înternă a datelor în variabile şi reprezentarea lor 
externă, în controale de vizualizare: ` 

"O legătură poate fi simplă dacă de proprietatea unui control se leagă 
un singur element. dintr-o colecţie de ‘date, sau complexă, când controlul 
este capabil să afişeze toată colecția de date. `; 


Exercitiu + 


Intr-o aplicaţie declarăm ca membru în formă, un vector de String 
vectFac şi-l inițializăm pe evenimentul Load al formei sau în constructorul 
formei, cu denumirea unor facultati. Adăugăm pe formă si un control 
TextBox numit txtFac. 

Controalele contin 0 colecţie de tip controlBinăingscollection 
numită DataBindings. Ea tine la rândul ei legări, (obiecte de. tip Binding 
) ale. diverselor. proprietăţi, ale controlului, cu valori ale unor variabile 
aparținând aşanumitelor tipuri „conectabile”. 

Tot pe evenimentul Load al formei completăm colecția cu o legătură 
între proprietatea Text a txtFac şi valorile din vectorul vectFac, astfel 
încât funcția de tratare a evenimentului să arate astfel: | 


private void Forml_Load (object sender, System.EventArgs e) 


{ 
string [] vectFac = 

{ "CSIE" ; "REI" ; "COM" ‘ "FIN" ; "MAN" F "AGR" }; 
txtFac.DataBindings.Add("Text",vectFac,""); 
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" Se observă că adăugarea s-a facut cu’ 6 versiune. supraîncărcată a 
metodei Aaa (), fără crearea explicită a unui obiect de tip Binding; explicit 
aceeaşi adăugare se putea face în doi paşi: 


Binding b= new Binding("Text",vectFac,““); 
ali cl tii irita ina ei po: 


La rulare constatăm că textBox-ul afişează deja denumirea primei 
facultăți; mai mult decât atât, dacă modificăm textul din control, automat se 
modifică şi denumirea conținută în vector, lucru ce se poate verifica dacă pe 
un buton Afiseaza se afişează într-un MessajBox primul element din 
vector, înainte şi după apăsarea pe butonul Schimba. 

Legătura este însă unidirectionala, adică modificând prin program 
denumirea primei facultăți, controlul nu îşi modifică automat textul afişat. 


Tipurile conectabile la controale sunt: 


e toate tipurile derivate din IList, inclusiv vectorii şi colecţiile, de tipuri 
fundamentale sau de tipuri introduse de utilizator; 
e tipurile care implementează interfețele [BindingList sau ITypedList, 


dintre care cele mai reprezentative sunt: DataSet,- DataTable, 
DataView, DataViewManager.- : 


Parametrii funcției DataBindings.Add()araté care proprietate. a 
controlului este legată, de care variabilă, iar dacă variabila este o instanță a 
unui tip introdus de utilizator, cel de-al treilea parametru precizează care 
anume proprietate (căci pot fi mai multe) a acestui tip va fi conectată cu 
controlul. 


' Spre exemplu, vom construi o clasă Pers care deţine două proprietăți de 
tip read / write, pentru nume şi respectiv pentru vârstă. Se observă că pot fi 
„nu și câmpuri simple, Chiar: dacă Je declarăm 


pub ice. 
De remarcat de asemenea, că proprietatea varsta este asociată câmpului 


int varsta, deci 
conţinut de controlul txtvarsta. 


către textul 


class Pers 
{ 
string nume; 
int varsta; 


public Pers( string n, int v) { Nume=n; varsta=v; } 
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public string Nume 
{ 


get { return nume; ) 
set ( numemvalue; } ` 


) 


public int Varsta 


{ . 
get { return varsta;}` 


set ( varsta=value;) 


) 
iar funcţia care declară legăturile arată acum astfel: 


private void Form1_Load (object sender, System.EventArgs e) 


{ 
Binding b= new Binding ("Text", vectFac, “YG 


txtFac.DataBindings.Add (b); 


txtPers.DataBindings.Add ( "Text", vectPers, "Nume") ; 
txtVarsta.DataBindings.Add("Text",vectPers, "Varsta"); 


} 


De remarcat că pentru varietate, "de această dată legarea controlului 
txtFac s-a facut mai detaliat, instantiind mai întâi un obiect de tip- Binding, 
care a fost adăugat apoi la colecţia DataBindings a controlului. 

In această formă, toate textBox- urile afişează doar prima componentă 
din vector; pentru a putea caves prin vector se folosesc obiecte specializate: 
un BindingContex ază mai multe obiecte de tip 
CurrencyManager, í ; la'rândul lui, 
un obiect currencyManager tine poziția curentă într-o sursă ae date, pozitie 
pe care o comunică tuturor controalelor legate la această sursă; cum este şi 
firesc, poziţia poate fi incrementată sau decrementată. Vom pune două: 


butoane de navigare, inscripţionate cu "<"şi ">", pentru defilarea "îi 


papon, şi 
"înainte" în vector. . 
Funcțiile de tratare a Click-ului pe aceste butoane conțin doar « câte 0 


instructiune şi realizează modificarea poziției curente: - 


BindingContext [vectPers] . Position -=1; 


şi respectiv, 


BindingContext [vectPers] .Position +=1; 
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Cum identificarea legăturii se face pornind de la sursa de date ( 
vectPers ), aceste instrucțiuni realizează defilarea în vector şi actualizarea 
concomitentă a tuturor controalelor care .sunt legate de acest vector (în 
cazul nostru, si numele şi vârsta, din cele două textBox- uri). 

Sintetizând, putem spune că pentru gestiunea unei legati) simple, NET 
Framework lucrează cu două tipuri de obiecte: 


e cate un CurrencyManager, 
la o interfață; 

e un obiect BindingContext, care tine evidenţa tuturor obiectelor 
de tip Currency Manager: 


BindingContext -ul dispune de o ideale care dacă primeşte 
numele unei surse de date, returnează obiectul CurrencyManager care se 
ocupă de legarea ei la un control, sau la mai multe, de pe o formă. 

Instrucţiunea: 

BindingContext [vectPers] .Position+=1; 

trebuie interpretată in sensul următor: CurrencyManager-ul gestionează 
legăturile vectorului vectPers cu controale existente pe formă; în acest 
scop, el păstrează şi poziția curentă în vector ( cea care este preluată de 
controale, la un moment dat); BindingContext-ul primeşte numele unei 
surse de date şi returneză prin indexare instanța CurrencyManager aferentă 
acelei surse; la rândul lui obiectul CurrencyManager îşi modifică poziţia 
curentă în vector, făcând să se preia alt set de valori (nume, vârstă) în 
controalele de afişare text. Funcția poate fi redactată si: altfel, _detaliind 
instrucțiunea BindingContext [vectPers]. Position+= 1; 


222 


$ _Legarea datelor de interfața utilizator — data binding 


private void btnStanga_Click... hoe da 
| (object sender, System.EventArgs e) 
i ' CurrencyManager crtMngr; 
// explicitare lucru cu CurrencyManager 
crtNngr=(CurrencyManagar)BindingContext \vechrers)7 
crtMngr. sal one! 


i i : vt sot 

Pot fi legate toate clasele derivate din Windows.Forms.Control, cu 

oricare din proprietăţile lor. Practic, legarea simplă oferă un mecanism 

foarte practic pentru a construi interfeţe erarige, care se reconfigureaza in 
functie de diverse date. 


Exemple de utilizare a legarii datelor. 


-1. Afişarea unui set de fotografii, legând un vector de imagini de 

= proprietatea Image a unui control PictureBox. 

„2. Corelarea automată a proprietății Value a unui control . 
ProgressBar cu magnitudinea relativă, a observaţiilor despre un 
fenomen. 

3. Corelarea culorii unui panel cu valorile unui decodor de Bree 


Controalele de tip container. pot avea la rândul lor propriul 
BindingContext, care gestionează manageri de legături pentru controalele 
pe care acestea le dețin şi care pot lega aceleaşi sau alte surse de date. 


Sursele de date care au şi un corespondent vizual în Designer, pot fi 
văzute de acesta, iar legarea se poate face şi vizual, selectând controlul, 
Properties / Data Bindings / Advanced ide se aleg atât proprietatea ce se 
va lega, cât şi sursa de date. i 


2: Legarea omplen complex data binding 


e Binding conecta un singur element dintr-un: model de date (un ` 
element din vector, în cazul nostru) de o singură proprietate a unui control. 
Complex Binding | 
unei surse. Spre exemplu, un grid poate afişa dintrodata, o intreaga tabelă 
dintr-o Vize de date, cu toate câmpurile ei. ts 
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Complex Binding reprezintă o modalitate comodă de a conecta volume 
mari de date cu elementele de interfață cu utilizatorul. Ni 
controalele pot beneficia de o astfel de legare, ci doar 
cum ar fi: ComboBox, ListBox, Grid etc. 


Ca exercițiu, în aplicaţia anterioară vom adăuga un ComboBox, iar pe 
un buton inscripționat "Leaga" adăugăm funcţia de tratare Click conținând 
doar liniile de cod: 


comboBoxl.DataSource = vectPers; 
comboBox1.DisplayMember = "Nume"; 
comboBoxl . ValueMember="Varsta"; 


La rulare, apăsînd butonul "Leaga" constatăm popularea casetei 
combinate cu persoanele din vectorul de persoane; mai mult decât atât, la 
selectarea unei persoane, constatăm că se modifică şi persoana afişată in 
TextBox-ul txtPers, de la legătura simplă. Acest lucru se explică prin 
faptul că acelaşi BindingContext gestionează ambele conexiuni cu ajutorul 
aceluiaşi obiect CurrenecyManager, iar modificând poziția curentă pe o 
sursă de date, toate conexiunile existente cu această sursă se aliniază la noua 
poziţie curentă ! 


- Lucrurile sunt valabile şi reciproc: defilând în vector cu ajutorul celor 
două butoane de navigare ale legăturii simple, se modifică şi persoana 
afişată în zona de editare din ComboBox. 


„Exerciţiu 


Editaţi numele persoanelor din txtPers şi defilând, constatati ce va 
afişa ComboBox-ul. Invers, editați numele persoanei selectată în zona de 
editare din ComboBox și observați dacă legătura simplă sesizează astfel de 
modificări. Tratati un eveniment la nivelul casetei combinate astfel încât să- 
şi modifice efectiv datele din zona listă (nu din vector !) atunci când ele au 
fost editate şi constatati acum efectul modificării lor asupra vectorului şi 
asupra celorlalte controale legate la vector. 


Rezolvare 


Compus din două părți ( zone de editare şi zona listă), comboBox-ul 
necesită actualizarea explicită a zonei listă, cu valorile modificate ale 
vectorului. 
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Afişarea unui vector in grid 


Există controale specializate în afișarea simultană a mai multor date, cu 
mai multe atribute. Spre exemplu, informaţiile despre mai multe persoane, 


"cu toate toate proprietățile definite în clasă ( Nume si Varsta ), pot fi afişate 
extrem de simplu, într-un grid: 


e se declară sau se trage din ToolBox un obiect DataGrid; 


private DataGrid dataGridi; 


e pe un eveniment,. se declară vectorul ca sursă de date care 
alimenteaza gridul: : 


dataGridi.DataSource = vectPers; 


Gridul se configurează automat şi va afişa atâtea coloane, câte 
proprietăţi sunt definite în clasa Pers. De observat că legarea complexă 
necesită doar fixarea proprietății DataSource a controlului, nu adăugare în 
colecția de legături. 

În fereastra de Properties asociată controlului de tip grid, în partea de 
jos există un link spre o fereastră secundară. de dialog pentru a stabili un 
AutoFormat. Pentru a stabili caracteristici ce nu apar în şabloanele oferite în 
fereastra de AutoFormat, se poate apela la proprietățile gridului afișate în 
Properties, modificându-le static sau dinamic, prin cod sursă. 


Modificând datele din grid, observăm că si conținutul vectorului 
de persoane va fi modificat; toate legările simple şi complexe operate 
anterior, confirmă şi ele modificările făcute. .: 


Se poate vorbi aşadar de: 


e legare unidirecțională, când modificările din sursa de date sunt 
operate şi în controale, dar modificările din controale nu au efect 
asupra datelor din sursă; este cazul le gării realizate prin ComboBox; 
modificarea numelui din zona de editare a casetei nu afectează - 
numele stocate în vector. i 


e legare bidirectionala, când modificările din sursa de date sunt 
vizibile în controale, iar modificările operate în controale se 
răsfrâng şi asupra datelor din sursa de date; este cazul legării simple 
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prin intermediul textbox-ului şi a legării complexe realizate prin ` 
intermediul gridului. 
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ADO. NEIS OBIECTELE DE LUCRU CU BAZE DE DATE 


e . e 


PS a ta e 


. 


mietiem în OET ADO.NET 
Conexiunea la baza de date 

DataAdapter - adaptorul 

DataSet — mulțimea de date 

Tabela de date — DataTable 

Relaţiile dintre date — obiectul DataRelation 
DataRow - tuplu de date 

DataView — vizualizarea . 

Obiecte de tip Command 


10. Lucru cu procedurile stocate 
11.Typed si untyped DataSet 


1. Introducere în tehnologia ADO.NET 


În principiu, accesul la comenzi SQL dintr-un limbaj de programare se 
_ poate face prin mai multe modalităţi dintre care cele mai frecvente sunt: 


ODBC (Open Data Base Connectivity), o interfață standardizată 
care transformă o cerere SQL în apeluri de funcții acceptate de un 
driver ODBC, care recunoaşte mecanismul de stocare şi regăsire. a 
datelor, specific unui SGBD; 
prin OLEDB (Object Linking and Embedding ), un 1 set de obiecte 
specilizate în stocarea şi regăsirea datelor şi care expun: 
= consumer interface: o interfață de nivel înalt, care oferă 
accesul dintr-un limbaj de programare la comenzi SQL; 
= provider interface, care grupează apelurile de nivel jos, 
specifice unui SGBD. 


Prima categorie de apeluri este transormată în apeluri de pe nivelul 
provider; pentru că nivelul consumer era totuşi prea jos, s-a creat ADO - 
Active Data Object, ca un alt nivel, şi mai înalt de abstractizare. 


ADO.NET este o dezvoltare a acestei tehnologii de acces la date. Ea. 


disponibilizează clase, interfeţe, structuri şi enumerări pentru accesul la 


baze date sub .NET Framework. Este proiectată să lucreze şi deconectat de 


la baza de date, stocând datele în memoria cache locală. 


Datele stocate pot fi modificate, iar modificările sunt operate abia a 


sfârşit, în BD. Avantajul vitezei de lucru este afectat de faptul că în lucrul pe 
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cale ae 


BD partajate nu avem cele mai recente actualizări, motiv pentru care această 
tehnologie nu este eficientă pentru aplicaţiile real-time, gen brokeraj. Ca 
urmare, ADO.NET include şi un mecanism de acces direct la BD prin 
intermediul unor obiecte DataReader. 


O altă caracteristică este folosirea ca suport alternativ a limbajului 
XML, făcând astfel o legătură între modelul relational de lucru cu BD şi 
modelul ierarhic, adoptat şi în accesul la baze de date plasate la distanță, în 
Internet, model descris cu uşurinţă în limbajul XML. 


ADO.NET disponibilizează prin clasele sale: 
= obiecte pentru conectare la sursa de date; 
= obiecte ce gestionează comenzi de manipulare; 
= obiecte container de date. 


In plus, ADO.NET expune și notifică producerea unor evenimente, 
permițând programelor să lucreze altceva în paralel sau să se alinieze şi să ia 
decizii în funcție de aceste evenimente. 


Ca o observaţie pentru programatorii sub ADO MEC, obiectul 
RecordSet din MFC este înlocuit în .NET cu două obiecte: un 
DataAdapter şi un DataSet, care permit operaţii pe baza de date chiar 
deconectati ( pentru acces rapid ) şi din mai multe aplicaţii simultan. 


Sub Visual Studio .NET, există două abordări posibile pentru realizarea de 
aplicaţii cu baze de date: 
- prin program, scriind direct cod sursă ce instanţiază şi foloseşte 
„obiecte specifice lucrului cu baze de date; 
- vizual, folosind controalele disponibilizate de Visual C# Şi asociate 
(categoria Data, din ToolBox) unor surse de date. 


Vizual se realizează şi se testează uşor programele cu un înalt grad de 
interactivitate, în timp ce pentru programe cu grad scăzut de interactivitate, 
cum ar fi elaborarea rapoartelor periodice, se preferă forma „programatică”, 
scriind cod sursă care foloseşte valori prestabilite, în locul celor introduse de 
utilizator. 


În demersul nostru, preferăm inițierea în ADO.NET folosind prima 
alternativă, pentru a înțelege exact ce obiecte şi ce metode există şi cum 
cooperează ele, după care se abordează şi lucru vizual cu baze de date, 
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punând Designer-ul să scrie cod şi exploatând interfața vizuală de ‘acces la 


baze de date, programatorul doar completând, in cunostiinta de cauză, acest 
cod. 


Obiectele cele mai importante prin care se implementează accesul la o 
bază de date sunt: conexiunea, adaptorul şi setul de date. 


2. Conexiunea la baza de date 


Este responsabilă cu realizarea legăturii fizice dintre o bază de date 
şi aplicaţia .NET şi depinde de tipul furnizorului de date. Diferenţele de 
implementare de la un furnizor la altul sunt majore, astfel încât generalizări 
se pot obţine doar folosind tehnici de legare şi încapsulare obiecte (OLE) 
sau drivere Open Data Base Connectivity (ODBC). 


Furnizorii frecvenți de surse de date (data providers) sunt: 

e SQL Server NET Data Provider pentru SQL Server 7. 0, scris 
complet în managed code şi considerat modul nativ de acces la BD 
sub ADO.NET. .. 

e OLE DB .NET Data Provider pentru SQL Server. 6. 5 s sau versiuni 
anterioare, Oracle şi Microsoft Access. l 

e ODBC .NET pentru: a răspunde dezvoltatorilor de aplicații care 
utilizează drivere ODBC pentru acces la date. ; 


O conexiune se poate crea în mai multe moduri:. ` 


vizual, folosind Server Explorer, din mediul integrat; 

prin program, folosind: „obiecte de > tip re 
OleDbConnection, sau odbcConnection; : oes l 

3. implicit, cerând unui DataAdaptor pe metoda F111() să încarce 
date dintr-o bază de date. ws 


N = 


lată cum se descriu cele trei tipuri de conexiuni, „specifice fiecărui 


provider. 
e conexiune OLEDB: 


string sirConex = a 
“Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\prod. mdb"; 
OleDbConnection myConex = new OleDbConnection(sirConex) ; 


e conexiune SQL 
string connectString = et 
“server=localhost;database = BDClienti"; 


229 


ADO.NET - Obiectele de lucru cu baze de date 


SqlConnection conn = new SqlConnection(connectString); 
{* 0... %/ | 

conn.Open(); 

Pe eds. FH 

if (conn.State == ConnectionState.Open) conn.Close(); 


e conexiune ODBC 


OdbcConnection conODBC; // există using System.Data.Odbc; 
System. Data. SqlClient. SqlConnection conSQL; 
// namespace dat explicit 


i OleDbConnection este definită î în i namespacr aa System. Data.oleDB, 
i SqlConnection în System.Data.SqlClient, iar OdbcConnection în 
System.Data.Odbc. 


Stările unei conexiuni şi semnificatiilor lor sunt următoarele: 
"~ Connecting — în curs de conectare, conexiune nedeschisă încă; 
= open — conexiune deschisă; l 
" Executing — în derularea unei comenzi; 
= Fetching —in timpul unei căutări în BD 


Într-o aplicaţie simplă, care declară using System.Data. OleDb se 
poate pune pe evenimentul click al unui buton codul: 


private void Ec vont lice ro batut sender, System. EventArgs e) 
{ 
string sirConex = $ 
"Provider=Microsoft.Jet.OLEDB.4.0;Data Sóurces e:\\prod.mdb"; 
OleDbConnection conex=new OleDbConnection(sirConex) ; 
try ANUT l Ai 


{ l 
conex.Open(); 
) ae . 
catch { MessageBox.Show("Esuare la deschidere BD"); ). 


if (conex!=null) 
{ i 
textBoxl.Text="\r\n Sir de conectare: "+ 
conex.ConnectionString;. 
textBox1. Text+="|rin Baza de date: "+ 
conex. Database; 
textBoxl.Textt="\r\n Interval Timeout: "+ 
conex. Connect ionTimecut .ToString(); 
textBox1. Text+="\r\n Stare conexiune: "+ 
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conex.State:ToString(); 
) 


conex.Close(); 


Prin acest cod se deschide o conexiune de tip 0leDbConnection şi i 
se afişează principalele proprietăți. Ele pot să difere ca număr şi conţinut 
pentru o conexiune de tip Sqiconnection. 


Spre exemplu, un string de conectare pentru sqlconnection nu conţine 


atributul Provider (Microsoft SQL Server fiind provider implicit). 


Un string de conectare pentru ODBC lucrează cu Data Source 
Name (DSN) înregistrat în prealabil în Registry. Pentru aceasta, sub 
sistemul de operare se alege Settings / Control Panel. / Administrative 
Tools / Data Sources (ODBC); în funcţie de drivere-le instalate în sistem 
se optează apoi pentru Adăugarea; eliminarea sau -reconfigurarea unei 
surse de date. as 

Conexiunile se pot crea şi, vizual, folosind Server Explorer. Sub Visual 
Studio, Server Explorer-ul permite la momentul proiectării vizuale a. 
aplicaţiei, să adăugăm noi conexiuni sau să ştergem conexiuni existente, să 
deschidem sau să închidem conexiuni, să gestionăm cozi de mesaje sau 
evenimente de. conectare la o bază de date. Detaliile privind aceste facilități 
sunt prezentate în capitolul Programarea vizuală a lucrului cu baze de 
date. 


231 


ADO.NET - Obiectele de lucru cu baze de date . 


aza de dale Oracle accesala pin conexiune: ODB 


3. DataAdapter - adaptorul 


FE 
anii ae EE y $2 


a 


+ Obiectul ’ ‘DataAdapter mediază schimburile de date inte un his 
Dataset şi baza de date, atât pentru partea de regăsire şi încărcare a datelor, 
cât şi pan salvarea datelor modificate. E] tine: 

“un set de comenzi de manipulare a datelor din BD 

e conexiunea la BD folosită la popularea DataSet-ului. - 


ie panty ey iy gee eon i E fi ta sp, 
Ea : 4 ` 3 a Sint a $ j zi 


“Mai precis, adaptorul asociază o conexiune de cele patru 'obiecte de 
tip comenzi, ce pot fi executate pe o bază de date: selectCommand, 
InsertCommand, UpdateCommand $i DeleteCommand. eee că 
„Principala sa metoda, Fi11( dataset, tabela) încarcă cu dat 
; dintr-un DataSet. În funcţie de comanda select a adaptorului, o 
tabelă din. DataSet poate conține date provenind din mai multe tabele din 
baza de date. 
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DataAdapter-ul Îucrează cu conexiuni deschise sau închise, caz în 
care deschide şi închide el implicit conexiunea. Dacă însă am deschis noi 
explicit o conexiune cu Open(), atunci este important să închidem tot 
explicit conexiunea, după ce am folosit-o ( adică după ce am apelat metoda 
Fili a DataAdapter-ului), căci DataAdapter-ul nu o va închide implicit. 


Comenzile conţinute de un adaptor sunt expuse ca proprietăți, fiind la 
rândul lor obiecte de tip Sqlcommand sau OleDbCommand. 


Fiecare DataAdapter mediază transferul de date între un singur 
obiect DataTable din DataSet şi rezultatul unei singure interogări printr-o 
comandă SQL; deci dacă sunt mai multe tabele sau mai multe tipuri de 
intrerogări se vor folosi mai multe obiecte DataAdapter, câte unul pentru 
fiecare interogare, sau se redefinesc de fiecare dată proprietăţile 
adaptorului (obiectele de tip XxxCommand ), pentru a corespunde fiecărui 
caz în parte. 


Proprietatea SelectCommand foloseşte la precizarea acţiunii de 
executat pentru umplerea DataSet-ului cu datele dintr-o bază de date. Mai 
precis, ea conţine fraza select necesară construirii metodei Fill a 
adaptorului de date, metodă ce suprascrie metoda Fill moştenită din clasa 
de bază şi cerută de interfața IDataAdapter. l 


InsertCommand, UpdateCommand şi DeleteCommand sunt apelate 
pentru a actualiza datele si în baza de date, când utilizatorul a efectuat 
inserări, modificări şi respectiv ştergeri, asupra  DataSet-ului. Aceste 
comenzi stau la baza execuţiei metodei Update () . l 

Metoda update() a DataAdapter-ului este sintactic asemănătoare 
metodei Fił1(); ambele primesc ca parametri un obiect DataSet şi un 
obiect DataTable;  similitudinea se ' explică prin faptul că au funcții 
comparabile, dar de sens opus: Fi11(). citeşte datele din baza de date î în 
dataSet, Update () scrie datele din DataSet î în baza de date. l 


Comenzile pot fi generate şi automat, doar selectcommand fiind 
obligatorie; ea poate fi scrisă direct ca proprietate sau poate fi dată ca 
parametru în constructorul DataAdaptor-ului. Celelalte comenzi trebuie să 
existe doar în momentul în care se invocă metoda Update () expusă de un 
adaptor şi în DataSet există tipul de modificare ce impune comanda 
respectivă. 
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Exercitiu 
„Să se testeze lucru cu un adaptor. 
Rezolvare 
Aplicație simplă, Visual C# care anunță: 


using System.Data.0OleDb; 
using System.Data.SqlClient; 


La nivelul formei se declara un obiect DataSet si un obiect DataAdapter: 
private DataSet dsProd ; 
private OleDbDataAdapter daProd; 


Vizual se adauga trei butoane gi un textBox, docat Left. 


se pune functia de tratare Click: 


Pe butonul 


private void Deschide_Click 
(object sender, System. EventArgs e) 
{ 
// AsProd si daProd sunt variabile globale in forma: 
dsProd = new DataSet ("dsProduse"); 


string frazaSQL = "select codp, denum, pret from produse"; 
string sirConex = 


“Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\prod.mdb"; 


daProd = new OleDbDataAdapter (frazaSQL, sirConex); 
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// variabile locale in functie , a a ae 
OleDbDataAdapter daAdapter2 = new OleDbDataAdapter. 
("select codm,denm from materiale", sirConex); 


OleDbDataAdapter daAdapter3 = new OleDbDataAdapter'! 
i (“select * from consumuri", sirConex) ; 


Variabila asproă de tip Dataset, declarată la nivelul formei, este 
aici instanţiată, obiectul primind şi un nume, în afara referinței. 

Un adaptor daProd, declarat global la nivelul formei, este instantiat 
pornind de la o frază select şi de la un şir de conectare, fiind folosit în altă 
funcție la popularea DataSet-ului, cu date preluate din tabela produse. 

După cum se observă, uneori tabelele sunt asociate implicit DataSet- 
ului, prin intermediul adaptorului, care citează tabela în fraza select; în acest 
caz nu mai este nevoie să adăugăm manual tabele la colecția Tables a 
DataSet-ului. | 


Funcţia de mai sus declară şi alte variabile locale de tip 
OleDbDataAdapter, Care stochează comenzi proprii de. interogare şi care 
pot fi folosite doar temporar și numai în această funcţie. 


Pe butonul tratăm click de mouse cu funcția: 


private void Incarca_Click (object sender, System.EventArgs e) 


{ 
daProd. Fill (dsProd); 


// deschide, umple dataSet si inchide automat conexiune- 


foreach(DataRow lin in dsProd.Tables[0] . Rows) 
'textBoxl.Text+= "\r\n"+lin["denum"]; 


Codul de mai sus, prin intermediul : obiectului. - daproa de tip 
OleDbDataAdapter, încarcă date in DataSet-ul dsProd, instantiat în funcția 
anterioara. 


- Metoda Fill. foloseşte la ; unor linii sau  împrospătaiea 
liniilor de date preluate din baza de date şi stocate în tabela unui DataSet, 
dacă nu se doreşte adăugarea la DataSet-ul deja încărcat o dată, acesta 
trebuie mai întâi golit, invocându-i-se metoda clear () . 

Secvența de mai sus poate fi pusă pe evenimentul Click al unui 


buton, într-o aplicație Windows Forms, care declară şi using 
System. Data.OleDb; 
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Liniile de date rezultate din interogare sunt apoi iterate pentru a obține 
un mesaj cu denumirea produselor. 


Consultand baza de date, dataAdapter-ul află şi schema de descriere a 
tabelei asociate. Această schemă poate fi salvată distinct şi consultată sau 
folosită ulterior. 

Pe butonul scriexMr, se adaugă codul pentru salvarea schemei de 
descriere a tabelei produse: i 


private void ScrieXMI, Click 


(object sender, System.EventArgs e) 
{ 
dsProd.WriteXm1 Schema ("produse.xsq" ); 


} 


Se poate vizualiza cu Wordpad fişierul produse.xsda şi apoi se poate 
da click în Windows Explorer pe fişierul respectiv, fiind vizualizată schema 
direct în editorul de sub Visual, unde schema poate fi şi modificată vizual. 

Deşi e o metodă de-a DataSet-ului, writexmlschema scrie scheme 
însuşite prin intermediul adaptoarelor, care au consultat baza de date şi au 

„extras schemele de descriere ale tabelelor asociate. 


Fişierul XSD este un fişier XML de tip special, în format extern, care 


poate conţine atât datele propriu-zise, cât şi metadatele (descrierea datelor) 
pentru a le putea interpreta corect la destinaţie. 7 l 

De asemenea, fişierul proăuse.xsă poate fi folosit sub un sistem de 
“gestiune a bazelor de date, la importul unei tabele din exterior ( de 
exemplu, sub Access, cu o bază de date deschisă, File / Get External Data / 
Import selectând fişiere de tip + .xsa se poate face un import de tabelă ) . 


4. DataSet — mulțimea de date 


Obiectul” Dataset este containerul de date; el corespunde unei 
implementări relationale a unei baze de date în memorie. Când datele provin: 
din mai multe tabele se recomandă definirea câte unui adaptor pentru fiecare 
tabelă. ~ l - l 
Structura unui obiect DataSet se prezintă în fig. 14.1 
Când DataSet-ul conține mai multe tabele, fiecare cu câte un adaptor 
de date asociat, trebuie invocată metoda Fi11 a fiecărui adaptor. 
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Obiectul DataSet marchează informaţia care a fost modificată ( la 
nivelul fiecărei linii de date există proprietatea RowState) şi menţine o 
copie şi a informaţiei originale, astfel încât o putem restaura când acest 
lucru se impune. 


- La apelul metodei update(), DataAdapter-ul analizează dacă sunt 
modificări în DataSet şi lansează InsertCommand, UpdateCommand, Ori 
DeleteCommand, în funcţie de tipul actualizărilor produse : adăugare de noi 


.. înregistrări, modificări sau ştergeri. 


Comenzile InsertCommand, UpdateCommand, Ori DeleteCommand 
trebuie să existe scrise înainte de apelul metodei update, altminteri este 
semnalată o excepţie, ori de câte ori lipseşte una din comenzile de 
actualizare şi ea este necesară, deoarece există actualizări de acel tip. 


Corespunzând unei reprezentări a datelor în memorie, DataSet-ul nu 
ştie de unde provin datele pe catre le conţine, ci cunoaşte doar structura lor 


'relațională. Ca urmare după o actualizare a bazei de date cu modificările 


operate în DataSet, trebuie notificată acceptarea sau refuzul de către baza de 
date, de a opera.modificările făcute; această notificare se face printr-un apel 
al metodelor AcceptChanges sau RejectChanges; în primul caz se face 
automat un "commit", iar în al doilea caz se va face automat un “roll-back” 
pentru a aduce DataSet-ul la starea de dinaintea update-ului. 


DataSet cu tabele multiple 
` Aşa cum am vazut deja, un Dataset poate conţine mai multe obiecte 


DataTable, câte unul pentru fiecare tabelă din baza de date. Mai există însă 
o nuanță: printr-o comandă ‘select bazată pe un join putem aduce date 


provenind din mai multe tabele ale bazei de date într-un singur obiect `- 
Í DataTable al unui DataSet. 


Dacă se doreşte actualizarea simultană a datelor provenind din mai 
multe tabele, trebuie specificat acest lucru explicit prin comenzile de update, 


| “deoarece dataset-ul lucrând independent de baza de date, toate relațiile . 


care au stat la baza încărcării inițiale, nu mai sunt cunoscute ulterior, 
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. Tabela de date — DataTable 


se poate crea independent sau legată de un DataSet. 


DataTable t1 = new DataTable() ; 
// primeste nume implicit Tablel 
DataTable t2 = new DataTable ("tabela 2") ; 
// primeste nume dat de programator 


legarea de un DataSet, prin adăugarea tabelei în colecţia Tables: 


DataSet ds = new DataSet(); 

as.Tables.Add(t1); ds.Tables.Add(t2); 

ds.Tables.Add(); 

// adaugarea unei tabele de nume implicit Table2 

foreach(DataTable crt in ds.Tables) 
msg+="\n"+crt.TableName; 

MessageBox. Show (msg); 


Exercitiu 


Să se exemplifice construirea, încărcarea şi exploatarea unui DataSet 


conținând două tabele, Clienţi şi Comenzi. Toate operaţiunile se execută 

doar în memorie, fără vreo conexiune cu o bază de date propriu-zisă. Se va 

defini o relație între datele conținute în cele două tabele, astfel încât să poată 
` fi regăsite toate comenzile aferente unui client, indicat prin cod client. 


Rezolvare 


Pe o aplicaţie Windows se pun: Pee 
un buton care să declanșeze toate acțiunile derulate în cadrul aplicației 
un textBox în care se introduce codul clientului ale cărui comenzi sunt 
afişate şi totalizate 
un textBox ce va afişa datele despre client (cod client şi nume) 
un listBox ce afişeză comenzile câte unui. client şi total cantitate 


comandată 


public DataSet ds; dată membră ce referă setul de date cu care se- 
lucrează în mai multe funcţii ale aplicației. 


Pentru declararea gi încărcarea dataSet-ului. se scrie o funcție 


Creazaset, ce va fi apelată din constructorul formei aplicaţiei: 
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private void CreazaSet() 


{ 


ds = new DataSet ("myDataSet"); 


// Creaza tabela Clienti 
DataTable tClienti = new DataTable("Clienti"); 


// Creaza si adauga doua coloane la tabela Clienti 
DataColumn CodClientClienti = 

new DataColumn("CodClient", typeof (int)); 
DataColumn cNumeClient = new DataColumn ("NumeClient“); 
tClienti.Columns. Add (CodClientClienti); 
tClienti.Columns. Add(cNumeClient) ; 


// Creaza tabela Comenzi 
DataTable tComenzi = new DataTable ("Comenzi"); 


// Creaza si adauga trei coloane la tabela Comenzi 
DataColumn cCod = : 

new DataColumn ("CodClient",, e PRL 
DataColumn cData_Comenzii = 

new DataColumn ("Data _Comenzii", typeof (DateTime) ) ; 
DataColumn cCantitate = 

new DataColumn("Cantitate", typeof(int)); 
tComenzi.Columns .Add(cCod) ; 
tComenzi.Columns.Add(cCantitate); 
tComenai . Columns .Add (cData _Comenzii); 


W 


// Leaga tabelele la DataSet. i A 
ds. Tables. Add(tClienti); i as. Tables. „Ada (tComenzi); 


// Creaza o relatie intre tabele, mediata de CodClient:; 
// DataRelation dr = new DataRelation 
// ("Client_Comenzi", CodClientclienti , Cod); 


. DataRelation dr = 


new DataRelation("Client _Comenzi *, 


“ tClienti. Columns [0] -,tComenzi.Columns{[0]);* } 
ue. Relations. Add (dr) ; . 


RENTE 


// Populare tabele 
DataRow linClienti; DataRow linComenzi; 


// trei Clienti in tabela. 

for(int i = 1; i < 4; i++) 

{ ‘ 
linClienti = tClienti.NewRow(); 
linclienti["CodClient"] = i; i 
linClienti["NumeClient"] =. “Client_ "+i; 
tClienti.Rows.Add(linclienti); 
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// Creare Comenzi pentru fiecare clients 
for(int i = 1; i < 4; i++) 


{ 
for(int j = 1; j < 6; j++) 
{ 


linComenzi = tComenzi .NewRow() ; 
linComenzi["CodClient"]= i; 
linComenzi["Data:iComenzii")= 

new DateTime(2004, i, j * 2); 
linComenzi["Cantitate"] = i * 10 +j * .1; 
// Adauga linia la tabela Comenzi 
tComenzi .Rows .Add(lincomenzi) ; 


Funcţia declară un obiect DataSet numit myDataset (a nu se 
confunda numele dataSet-ului cu referința ds) şi două obiecte DataTable ce 
referă două tabele numite Clienti și Comenzi. Lor li se constituie colecţia 
Columns prin adăugarea de câmpuri ce definesc coloanele fiecărei tabele 
(Coaclient, NumeClient, pentru prima tabelă, respectiv coaclient, 
Data_Comenzii şi Cantitate, pentru a::doua tabelă .).. Nu trebuie 
confundate referintele de DataColumn cu denumirile de coloane, care sunt 
stocate: ulterior şi în baza de date; referintele de obiecte sunt folosite doar 
temporar la adăugarea coloanelor la colecția columns, a DataSet-ului. 

Tabelele astfel configurate sunt adaugate apoi la colecja Tables à 


DataSet-ului. 


6 ae dintre date — obiectul DataRelation 


DataRelation este un obiect care înregistrează iepřiurile (relațiile) 
dintre tabele şi permite explorarea lor pentru regăsirea datelor. o 2 

Spre exemplu, o legătură 1-M între tabela referită prin tclienti şi 
tabela referită prin tcomenzi permite regăsirea facilă a tuturor comenzilor 
făcute de un client. 

Dispunând de cele două tabele deja ataşate unui DataSet, putem 
introduce o relație între tuplurile celor două coloane, dând un nume relației 
şi precizând cele două coloane, "parent" şi "child", aparținând celor două 


„tabele diferite, care mediază legătura. 


e cand cunoaştem referinţa fiecărei DataColumn, sub forma : 
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DataRelation dr = . : 
new DataRelation("Client.Comenzi" CodclientClient; cCod) ; 
ds.Relations.Add (dr); 


e cand cunoaștem poziția coloanelor în colecția Columns a fiecărei 
tabele: 


DataRelation dr = new DataRelation("Client_Comenzi", 
tClienti.Columns[0] ,tComenzi.Columns[0]); 
ds .Relations.Add (dr) ; 


e cand cunoaştem numele coloanelor ce mediază relaţia dintre cele 


două tabele: 
DataRelation dr = new DataRelation("Client_Comenzi", 
tcClienti.Columns["CodClient"], 
tComenzi.Columns["CodClient"]); 
ds.Relations.Add (dr); sii i 


‘© Urmează apoi popularea celor două tabele cu date generate ad-hoc; 
pentru încărcare este nevoie de obiecte DataRow, care referă câte o linie de 
date din fiecare tabelă, linia fiind structurată conform structurării pe coloane 
a fiecărei tabele; acest lucru face ca obiectele DataRow să nu aibă 
constructori proprii, ci să fie construite uzual folosind metoda NewRow() ce 
aparţine unei tabele, care îşi cunoaşte propria colecţie de coloane. 

DataRow crează în acelaşi timp şi containerul de date, astfel încât 
refolosim referința linclienti, dar dăm tclienti.NewRow() în. for, 
creând câte un container distinct pentru fiecare tuplu de date din tabelă. 

Un element din linia de date este referit prin numele coloanei căreia 
aparţine sau prin indexul poziției pe care o ocupă ( NumeClient este a doua 
coloană, deci ocupă poziţia 1): 

linclienti ["Numeclient"] = "Client_"+i; 
sau... l dă 
“ linClienti [1] = "Client "+i; 


i 


Funcţia care tratează evenimentul click pe butonul de căutare a 


comenzilor aferente unui client are următorul conținut: 


private void cauta (object sender, System.EventArgs e) 
{ 
„int cc = Convert.Tolnt32 (ecoâ.Text) ; 
// preluare cod client 
Decimal Total = 0; int cant = 0; 
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` DataTable tClienti = ds.Tables["Clienti"]; 


DataColumn[] vect_chei = new DataColumn[1); 

vect_chei[0] = Gi. 
ds.Tablesl["Clienti"] .Columns["CodClient"]; 

ds.Tables["Clienti"].PrimaryKey = vect_chei; 


DataRow-linSelectata = tClienti.Rows.Find(cc); 
//DataRow linSelectata = tClienti.Rows[0]; 


//Navigheaza spre comenzi folosind relatia Client_Comenzi 
': DataRow[] vectLinii: = îi 
i linSelectata. GetChildRows ("Client _Comenzi"); 
// Afiseaza Clientul : che: 
afis.Text+=(cc+" "+tlinSelectata[{"NumeClient"]+", " ); 
string linia=""; i 
for(int i = 0; i < vectLinii.Length; i++) 


{ 
linia=""; 
foréach (DataColumn colCrt in ds. Tables ["Comenzi"]. Columns) 
liniat=vectLinii[i][colCrt]+" ©"; 
listBoxl.Items.Add(linia); 
cant = (int}vectLiniili]["Cantitate*]; 
"Total += cant; Bi s 
} : 5 
„linia=""; liniara..." -j 
listBox1.Items.Adâ(linia); 
linia=""; linia+=Total; listBoxl. ‘Items. Aaa (linia); 


După ce extrage codul introdus de utilizator pentru clientul ce face 
obiectul căutării, funcţia pregăteşte căutarea după o cheie; în acest sens se 
înregistrează câmpul codclient din tabela Cok drept cheie primară. 


H 


DataColumn[] vect_chei =-new pataColumn [1]; 
vect_chei[0] = ds.Tables["Clienti"]. Columna {"Codelient*}; 
ds.Tables(*Clienti"].PrimaryKey = vect_ chei; . 


_ Pe scurt, cheia primară se Înregistrează setând proprietatea 
PrimaryKey a tabelei. 

O cheie primară poate fi compusă din mai multe subchei; ca atare-se: 
declară un vector de patacolumn, ce pot reprezenta subchei, iar la 
instantierea vectorului se precizează din câte- câmpuri se compune ( unul, în 
exemplul nostru); se încarcă apoi fiecare element din vector, cu referința 
câte unei coloane care intră în componenţa cheii primare. 
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În final, referința vectorului conţinând cheia primară se înregistrează 
drept proprietate PrimaryKey a tabelei Clienti. O dată înregistrată o cheie 
primară, putem folosi căutarea după cheie, apelând la metoda 3 
colecţiei tclienti.Rows, în care căutăm: 


DataRow linSelectata = tClienti.Rows.Find(cc); 


unde cc este o variabilă int, conținând valoarea cheii de căutare Deacu 
CodClient. 


tii se bazează pe existența metodelor 
în clasa DataRow, prin care fiecare tuplu 
(linie de date) vede care linii de date îl leagă si care sunt liniile de date pe 
care el le leagă, la rândul lui. 


Presupunând că avem deja selectată mai sus linia de date despre un 
client, se pot extrage toți «fiii» acesteia, în cazul nostru comenzile 
clientului, existente în cadrul relației C1ient_Comenzi : 


// Navigare spre comenzi folosind relatia Client Comenzi 


// Afiseaza Clientu 
afis.Text+=(cct" “+linSelectata["NumeClient"]+" wo); 
string linia=""; i i 
for(int i = 0; i < vectLinii.Length; i++) 
{ = ` ; 
linias""; mn ae 
l foreach (DataColumn colCrt in ds. Tables Conteaza! de Columns) 
liniat=vectLinii [i ) [colCrt]+" "iu 1 
listBoxl.Items.Add(linia); 
cant = i ae oleae a ae 
Total += cant; | : 
) mA aa 
linia=""; linia+="~----------------------- a 
listBoxl.Items. Add (linia); 
linia=""; liniat=Total; listBoxl. Items. Add(linia); 


Exercifiu 


Să se definească două relaţii pe o bază de date despre produse, astfe] 
încât să permită afişarea Costurilor materiale pe produs sub forma unui 
raport, de genul celui prezentat în figura de mai jos:.. 
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Rezolvare 


Fata de lucrul cu obiecte Relation din exemplul de mai sus, problema se 
complica prin : 
- preluarea datelor dintr-o bază de date, nu direct din dataSet; - 
- existența la nivelul formei a câte unui adaptor pentru fiecare 
dintre cele trei tabele de date produse, materiale, consumuri Şi a 


unui Singur dataSet : oe, 


public OleDbDataAdapter daProd, daMat, daCcons; - 
public DataSet dsprodConsMat ; 
string strConex; 


instantiate corespunzător în constructorul formei : 


strConex= 
*Provider=Microsoft.Jet.OLEDB.4.0;Data Sourcesc: \\prod.mdb"; 


daProd=new OleDbDataAdapter ("SELECT * from produse",strConex) ; 
daCons=new OleDbDataAdapter ("SELECT * from: consumuri", strConex); 
daMat =new OleDbDataAdapter ("SELECT * from materiale", strConex);.- 


asProdConsMat = new DataSet(); 
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TIE 


catch (Exception excpt) x 
{ textBox1.Text="Esuare relatie MatToCons "4 excpt. Message; } 


) 


„„„*" navigarea folosind două relaţii, una de la produse către consumuri, a 
mediată de cod, pentru identificarea tuturor consumurilor materiale 
aferente unui produs şi alta de la materiale la consumuri, pentru 


identificarea tuturor consumurilor dintr-un anumit material. în care sunt captate şi semnalate Pi mesaje adecvate, eventualele excepţii 


legate de: 
- nepotrivirea numelui si a tipului de date din coloanele care 
mediază relaţiile; 
= existența unor consumuri ale căror coduri (de produs ` sau de 
material) nu au oorpore în tabelele părinte etc. . 


Explorarea relaţiilor, pentru a decid cerintelor informationale dle 
raportului menționat, se face cu funcția: 


- încărcarea tabelelor în acelaşi dataSet, prin invocarea fiecărui 


private void Calcul_Click (object sender, System.EventArgs e) 
` GataAdapter asociat: 


{ 


; A . xti ; = le ‘materi le pe produs \r\n"+ 
private void Incarca Click (object sender; System.EventArgs e) textBoxl. Text Costuri = A PSP 


i foreach (DataRow prodCrt in dsProdconsMat. Tables | "produse" ] .Rows) 


daProd. Fill (dsProdConsMat, "produse") ; t 


daMat.Fill(dsProdConsMat, "materiale"); 
daCons. Fill (âsProdConsMat , "consumuri") ; 


decimal valTot=0; 
textBox1.Text += prodCrt ["denum"]+ 


) 


Man 


Definirea celor două relaţii se poate face cu o funcţie de genul următor: 


foreach (DataRow consCrt in vectLinii) 
{ 
DataRow linMat= 
double valConsum= double) conscrt | "consum" ] , 
pretMat= (double) linMat["pret"]; 
textBoxl.Text+="\t"+ linMat["denm")+ "\t"+ valConsum+ 
"\t x \t"+pretMat+"\t = "+valConsum*pretMat+"\r\n"; 
.valTot += (decimal) (valConsum*pretMat) ; no 
f } zisă ae : is 
textBox1.Text += 


private void Relatii_Click (object sender, System.EventArgs e) 
{ x ` ià l y he A - : 


try 
{ ă : : FVA 
DataRelation drProdToCons = new DataRelation(*Prod Cons", 
' asProdConsMat. Tables["produse"]. Columns ["codp"] : 
dsProdConsMat.Tables["consumuri"]. Columns ["codp" } 3 
dsProdConsMat. Relations .Add(drProdToCons) ; ; ; 
textBox1.Text="Relatie Prod_Cons stabilita"; 


) “Nrino nn cee cere nnn ee Nrinn 
catch (Exception exept) textBoxl.Text += « 1 n Vi wy 
{ textBox1. Text="Esuare relatie ProdToCons "+excpt. Message; ) "Total pe produs MEAENEAE t AVE DOE = su 


try 
{ 

DataRelation drMatToCons = new DataRelation("Mat_Cons" 
dsProdConsMat.Tables["materiale"].Columns["codm"] i 
dsProdConsMat . Tables ["consumuri"] .Columns ["codm"]); 

dsProdConsMat .Relations.Add(drMatToCons) ; 

textBoxl.Text+="\r\nRelatie Mat_Cons stabilita"; 


Se observă că explorarea relaţiei "Prod_cons" s-a făcut pe sensul 
“înainte”, identificând. toate înregistrările  - copil “(apelul * 
prodCrt.GetChildRows("Prod_Cons")), în timp ce explorarea relației 
“Mat_Cons" s-a facut pe direcția “înapoi”, identificând înregistrarea părinte 


(apelul conscrt.GetParentRow("Mat_Cons")). 
) 
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7. DataRow — tuplu de date 


În multe din exemplele anterioare am utilizat un alt tip de obiect 
necesar lucrului cu baze de date şi anume obiectul pataRow. Ne vom opri 
acum mai mult asupra acestuia. Exemplul de mai jos defineşte un obiect 
DataRow îl configurează conform structurii tabelei Facturi, îl încarcă cu 
date conforme cu tipul fiecărui câmp şi adaugă noua linie la datele tabelei 
respective: 


DataRow linNoua `; i 
linNoua = m_ds.Tables["Facturi"] .NewRow(); 
linNoua{“codFactura"] = 101; 
linNoua{"numeClient"] = “Petrescu I"; 
linNoua["Data"] = new DateTime(2005, 5, 1);; 
m_ds.Tables[(“Facturi"].Rows.-Add(1inNoua) ; 


Secvența de mai jos operează tot cu obiecte DataRow, dar le identifică 
nu prin referință ca pana acum, ci prin indexare: 


ds.Tables[(1].Rows[3] [2] .ToString(); i 
ds . Tables [| "Comenzi “ ] . Rows [3} ["Cantitate"].ToString(); 


„Se observă că linia de date nu poate fi localizată decât prin poziție în 
colecție, spre deosebire de tabele şi coloane, care pot fi individualizate prin 
poziţie în colecţie, dar şi prin nume. | 

Un nume de coloană nu trebuie să conţină caractere speciale (Spaţiu, 
virgulă, punct, ghilimele etc.) şi poate fi specificat î în formă completă 
SchemaName . 'OownerName .TableName. . 

. Pentru a şterge linii de date dintr-un ‘dataSet trebuie mai întâi, liniile 
să fie marcate ca şterse, instanță cu instanță, invocând metoda Delete a 
dataSet-ului. Ulterior, la apelul update pe dataAdapter, liniile marcate ca 
şterse vor fi şterse şi din baza de date. 


manea înnoit a i ena seaneeunconsensentnnentntenttesensementnensenesneee narm dene ean seen ty 


Metoda Remove șterge fizic liniile din colecția Rows; 
nemaiexistând în colecție, la momentul apelului update pe dataAdapter, 
nu vor ma fi găsite ca marcate pentru ştergere, astfel încât ele nu vor fi 
; şterse şi din baza de date. | 
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Editarea unei linii de date: BeginEăit, EndEdit, CancelEdit 


Când se efectuează editări masive pe un dataSet, se câştigă timp 
amânând verificările de restricţii şi declanşarea unor evenimente asociate, 
până la terminarea tuturor editărilor. Realizăm acest lucru anunțând printr- 
un apel BeginEdit () al liniei. La terminarea editărilor se apelează una din 
metodele EndEdit() sau CancelEdit(), in raport cu ce se doreste: 
recunoaşterea editărilor sau renunțarea la ele. 


Acest lucru explică de ce încălcarea unor restricții nu este semnalată 
în blocul try - catch propriu operaţiei, ci abia după încheierea editării, la 


apelul EndEdit (). 


Proprietatea Rowstate a unui obiect DataRow 


In completarea informației privind valorile ale 
unei coloane, DataRow tine şi o proprietate , care indică starea 
fiecărei linii în parte: Added, Deleted, Detached, Modified sau 
Unchanged. l 


-. Detached - 0 linie este în starea Detached cînd a fost creată, dar n-a 
fost încă adăugată la vreo colecţie Rows a vreunui dataSet, sau a fost 
adăugată, dar apoi a fost scoasă cu Remove. 

~ added - tuplu a fost adăugat la DataRowCollection, dar n- -a fost încă 
cerut un AcceptChanges. | 

- Deleted - linia a fost stearsă folosind. ietie Delete a obiectului 


DataRow. . Tentativa de a © accesa produge -o excepție 
DeletedRowInaccessibleException. 


- Modified - una sau mai multe coloane . au: ferit E ale 
valorilor conținute, dar n- a fost î încă cerut un AcceptChanges 


- Unchanged - linia n-a suferit nici o modificare de la ultimul 
` AcceptChanges, terminat cu succes. i 


Versiunea unui obiect DataRow 
Înainte de acceptarea unor schimbări, dataSet-ul tine ambele versiuni 


ale liniei de date. Proprietatea Item a unei linii de date poate specifica o 
valoare din enumerarea DataRowVersion, pentru a preciza care dată este 
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cea dorită. Câmpul Version poate lua valorile :-original,: Default, 
Current si Proposed, cu semnificatia : 


Current - valoarea curentă din linie, modificată sau nu; 


- ' Default - valoarea returnată adecvată stării din proprietatea RowState; 
- Original - valoarea cu care linia a fost încărcată inițial;. | 
- proposed - valoare modificată a , liniei, între “momentul. cererii 


BeginEdit Şi înainte ca EndEdit Sau “CancelEâit să fie dat. 


Pe durata editării, doar Current şi Proposed sunt Jisnu: După 
CancelEdit, valoarea Proposed nu mai este disponibilă. După EndEdit, 
valoarea Proposed ia locul celei din Current, iar valoarea Proposed nu 
mai este disponibila. 


AcceptChanges şi RejectChanges 


Prin "apelul EndEdit () pe un DataRow nu cula efectiv şi 
- schimbările definitive pe linia de date. Consacrarea definitivă a 
modificărilor se realizează doar printr-un apel AcceptChanges sau 
RejectChanges, metode disponibile atât la nivel de DataSet, cât şi la 
DataTable si DataRow. Acest tip de apel termina editarea liniilor de date din 
domeniul respectiv, dând implicit şi EndEdit() sau CancelEdit(), dacă 
încă nu se daduse apaa un astfel de apel. - 


we 


Dupa apelul valoarea Current se înregistrează 
ca valoare original, pentru: fiecare camp. Dacă nu s-a apelat: încă 
EndEdit(); valoarea Proposed este luată în acelaşi timp drept valoare 
Current şi valoare original. Dacă RowState indica una din stările Added, 
Modified sau Deleted, ea va deveni Unchanged si toate modificările devin 
elective. ae BS 

După un anal. ; valoarea Proposed este ştearsă, 
renuntandu-se definitiv la ea. Dacă RowState era una din stările Deleted 
Sau Modified (adică pentru liniile şterse sau modificate), valorile sunt 
înlocuite cu cele existente anterior modificărilor, iar RowState este pusă pe 
Unchanged. Dacă Rowstate era Added, linia este eliminată din colecția 
Rows a dataSet-ului. - 
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- Deoarece după un apel. “AcceptChanges(), RowState devine 
Unchanged, apelând î în continuare metoda Update a DataAdapter-ului, nu 
opera nici-o modificare în baza de date. În consecință, apelul 


pe oricare DataRow, DataTable sau DataSet. 


; în Caz contrar este 
captată o excepție, în interiorul căreia se apelează Rej ectChanges. 


„Dacă nu rejectăm schimbările in cazul eşecului operării lor în baza 
de date, liniile rămân modificate în DataSet, astfel că la următorul apel de 
Update, cererea va fi din nou refuzată, deoarece pe lângă liniile nou 
modificate, cele vechi neoperate sunt încă tot în aşteptarea actualizării. 
Deoarece DataSet-ul este gândit să lucreze şi independent de baza de date, 
faptul că un Update este operat cu succes pe baza de date, nu are nimic 
a face cu acceptarea sau refuzul schimbărilor. î în liniile de date ale 
DataSet-ului. 


Transactions şi Updates 


Operatiile cerute printr-un Update nu se executa neaparat într-o 
singură tranzacție, lucru important când la baza de date sunt conectaţi 
simultan mai multi utilizatori. Pentru a forţa efectuarea întregului update 
într-o singură tranzacție conexiunea trebuie să anunțe BeginTransaction, 
moment în care primeşte un obiect sqlrransaction. Acest obiect dispune 
la rândul lui de metodele. Commit $i Rollback pentru închiderea 
tranzactiei. 


Succesiunea de derulare va fi în acest-caz: open pe conexiune, 
BeginTransaction pe Conexiune, Commit sau Rollback pe eee 
Transaction; Close conexiune. 


8. DataView — vizualizarea = 
Clasa Dataview oferă un mod de vizualizare a unui obiect dataSet. Ca 


funcționalitate, această clasă oferă posibilitatea filtrării / sortării datelor 
dintr-o tabelă; se comportă ca o colecție de linii şi are conţinutul bazat pe o 


condiţie dintr-o frază Select, cu avantajul că deținând obiecte de sine 
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Stătătoare, permite oi ae atat static. ue design), cât si la momentul 
execuției. : 

Mecanismul este simplu: « se instanțiază un obiect DataView soiul de 
la o tabelă din dataSet si se fixează proprietățile dataView-ului, printre care 
sau ; când selecţia se bazează pe starea unei 
linii de date (în curs de modificare, ştearsă, nou adăugată etc.) 


Aceleaşi tabele ale “unui "DataSet pot avea mai multe vizualizări 
asociate, reprezentând puncte, de vedere diferite; ale unor utilizatori şi în 
raport cu acestea se vor folosi diverse criterii de selecţie. 

În plus, un obiect dataView poate fi legat de controale cu vizualizare, 
cum ar fi ComboBox, ListBox, DataGrid etc., asigurând descrierea facilă a 
părții de interactivitate a aplicaţiilor cu baze de date. 


Exercitiu 


Folosind conceptul de DataView să se afişeze într-un textBox produsele 
cu un pret peste o limită dată, produsele nou adăugate într-o sesiune de 
lucru, respectiv toate produsele dintr-o bază de date. 


Rezolvare. 


1. Într-o aplicație C# Windows App se pun: | i f a 
-  textBox1 cu proprietățile Multiline = true, Dock = Right, 

; ScrollBars = Both, ReadOnly = true; i i 
`- button! inscripționat „Filtreaza” a 


i le i. s Ba SS. ay Ae d Mg Bee See rut ea evenimentului Click pe butonul Filtreaza se scrie funcţia: 
2. În clasa Formi se declară un DataSet și un OleDbDataAdaptor?. Pent Tarar Dr ae se eee ee E , 
private void Filtreaza Click (object sender, System.EventArgs e) 
Gut aes zi Med ti eae Am 
DataView Scumpe = iti a o 
new DataView( ProduseDs. Tables ["Produse"] ); 
„ Scumpe.RowFilter = "(pret > :300). AND (pret < 1500)" 


OleDbDataAdapter ProduseAD; 
-DataSet ProduseDSs; . 


care se instanţiză î în constructorul clasei Form1, folosind apoi la î încărcarea 
datelor despre produse: “att a 


ProduseDS = new DataSet ("setul_meu"); 
string frazaSQL = “select codp, denum, pret from produse"; 
string sirConex = 

"Provider=Microsoft:Jet.OLEDB.4.0;Data Source=c:\\prod.mdb"; 
ProduseAD= new OleDbDataAdapter (frazaSQL, sirConex) ;. 
ProduseAD. Fill (ProduseDS, "produse") ; 


DataView ProduseAdaugate = 
; new DataView( ProduseDS. mables ["Produse*] yos 
Prođušeađaugate- RowStateFilter= DataViewRowState.Added; 


PrintProduse ( Scumpe, Lista coace scumpe" .); 
DataRow linNoua = ProduseDS. Tables | "Produse" ] .NewRow(); 


linNoua["codp"] = "xl"; linNoua["denum"] = "Prod-Noi"; 
linNoua ["pret"): 400; i 
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ProduseDS. Tables |" Produse” ] . Rows „Ad | linNoua 2] 4; me 


linNoua = ProduseDs. Tables{* Produsė“]. linNoua (); 
linNoua["codp") ='"x2";  linNota["denum"] = "Prod No2"; 
linNoua["pret"]}] = 300; 
ProduseDS. Tables [ "Produse" ] .Rows.Adâd( linNoua ); 


PrintProduse E 
( ProduseAdaugate, “Lista produselor adaugate"); 
PrintProduse( Scumpe, "Lista produselor scumpe”) ; 


Pentru facilitarea afişării în textBox,. se va scrie o funcţie de forma : 


private void PrintProduse ( DataView crtView, string titlu) 
C l 
textBoxl.Text += "\r\n\r\n"+ titlu: 


textBox1.Text+="\r\n \r\n"; 
for (int i=0; i< crtView.Count; i++) 


{ 
textBox1.Text+="\r\n\t"+ iaaa 


"\t'+ertView[i] ["denum"]+"\t"+ertviewl4] ["pret"]; 


Ieşirea afişată pe textBox va sarata ca i figura de mai sus. 


S-au folosit proprieta RowFilter Care E species cansi ce stă la baza 
filtrării: 


“Scumpe.RowFilter = "(pret > 300) AND (pret < 1500)"; 


respectiv RowStateFilter, care selectează înregistrările pe baza stării lor 
(Added, Deleted, enenanged oe) 


Scara iata dia RowStateFilter = DataViewRowState.Added; 


Obiectul DataView este “bindable” ceea ce îi conferă o mare utilitate în 
manipularea unor subseturi de date,: vizualizabile în grid. De remarcat că 
modificările au rămas la nivel de DataSet, nu s-au propagat şi în baza de 
date, dar acest lucru este posibil printr-un apei Update (), specific 
adaptorului ProduseAD. | 

Fiecărei tabele îi pot fi asociate mai multe DataView- -uri; o tabelă 
dispune de cel putin o vizualizare implicită, cea înregistrată şi în 
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proprietatea: DefaultDataView. Proprietăţile: acesteia pot fi setate doar la — 
momentul execuţiei, nu şi Static, cu Designer-ul. 

Deşi se aseamănă cu DataRow, liniile unui dataiiiew. sunt an tip 
DataRowView, deoarece ele pot avea şi alte proprietăți, specifice doar 
vizualizării: 


DataView — vizualizarea căreia îi aparține linia; 

isEdit — true, când linia a fost editată | 

e IsNew - true când DataRowView este nou adăugată 

¢ [index] —indexarea ce returnează valoarea unei coloane din DataRowView 
+ Row - DataRow căreia îi asigură vizualizarea . 

e RowVersion - versiunea curentă a DataRowView 


DataRowView dvr = ToateSortate[2];. // selectarea linie 2 
MessageBox. Show (dvr [2].ToString());// afisarea coloanei 2 


Sortarea înregistrărilor unui DataView 


registrărilor unui DataView se face simplu, indicând în 
a vizualizării, expresia de sortare, ca o listă ordonată de 
coloane, .eventual urmate de-cuvintele cheie ASC. sau DESC, indicând 
ordinea de sortare : 


private void btnSorteaza_Click (object sender, EventArgs e) 
i i b a i i 
DataView ToateSortate = 
new DataView ( ProduseDs. Tables ["Produse"] yy 
ToateSortate.Sort="prét, denum: DESC"; 
PrintProduse(ToateSortate ,; "Lista: prodûselor sortate"); 


. Select î întoarce un array gD ROWS. f 
DataViewManager lucrează similar DataSet -ului, fiind un 1 container pentru 
DataViews. . i 


SUS eae abea 


9. Obiecte de tip Command 
„ Clasele de tip command (sqicommand, | 01eDbcomniană ) sunt folosite 


pentru a executa o comandă SQL sau proceduri stocate. Constructorii lor 
primesc o instrucţiune SQL sau numele procedurii stocate şi un obiect 


255 


ADO.NET - Obiectele de lucru cu baze de date 
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conexiune; există versiuni. de. supraîncărcare ce primesc: ADA A unii' dintre 
paramen de intrare, ceilalţi ici fi ada ulterior. Pe ' ; 


OleDbCommand aa. =. , . ra 
new OleDbCommand ("SELECT ` * FROM PEPER . con); 


Sau 


SqlCommand cmd = new SqlCommand() ;| 

emd.CommandText = "SELECT * FROM Clienti"; 

cmd. Connection = con; 

Obiectele desi tip Command reprezintă: unica modalitate prin care în 
ADO.NET se execută comenzi pe o sursă de date; sunt utile execuţiei 
comenzilor de INSERT, UPDATE şi DELETE, fiind înregistrate ca 
proprietăți la nivelul obiectelor DataAdapter; ele pot genera însă şi obiecte 
DataReader si XMLDataReader ( de tipuri adecvate provider-ilor: 
OleDbDat aReader, SqiDataReader etc.), putând accesa baza de date j 
_ In acest sens, obiectele XxxCommand preiau 
în „locul adaptorului, String-ul de conectare şi 


ele prin constructori, 
conexiunea: 


OleDbCommand: myCmd =-new OleDbCommand (strSql, con); 


in plus, obiectele de tip Command deţin o colecţie Parameters, ce 
reuneşte  pârametrii necesari unor comenzi mai sofisticate şi care sunt 
necesari şi apelului de proceduri stocate. 


Clasele de tip XxxParameter (Si ipadei ie a. OleDbParameter ) 
sunt cele care permit adăugarea de parametri la o comandă; parametrii au un 
nume, un tip, o direcție input sau output şi o valoarea; ei se adaugă la 
colecția Parameterscollection Je care 0 deține fiecare 
comandă. fot Tea a ae 
" Direcţia este implicit input, dar poate fi dată! si Se ; 

„Detalii privind clasele de tip xxxParameter sunt date mai jos, în 
paragrafele privind utilizarea procedurilor stocate. 
direct la baza de date sunt de trei tipuri: | 
„ care întoarce o colecţie de linii de date, 
accesibile apoi linie cu linie; 
are returnează o singură valoare, de tip generic 


e 
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Care nu returnează nimic, dar execută 
actualizările asupra bazei de date, 'generate prin modificări, 

i ştergeri sau inserări în baza de date. 
Obiectele claselor de tip “Reader ( sqlDataReađer, 
OleDbDataReader ) pot fi generate de către obiectele de tip Command prin 
apelul şi furnizează un flux de date, read-only, 
disponibilizand cate o înregistrare la fiecare apel al metodei Read(), spre 


- deosebire de metoda Fill) a unui adaptor, care furnizează o colecţie de 


înregistrări : 
OleDbDataReader dr = myCmd.ExecuteReader ();. 


DataReader-ul pointează aprioric pe BOF şi e nevoie de o citire 


4 


„prealabilă pentru a avea o înregistrare. 


Parcurgerea cu DataReader este simplă şi se aseamănă cu citirea câte 
unei înregistrări dintr-un fişier. Localizarea unui câmp în înregistrarea din 
DataReader se face prin indexare, sau cunoscând numele coloanei din 
tabelă. | 

textBox1.Text = ar["pret"); 

Funcţia de mai jos, pusă pe butonul unei forme, listează într-un 


TextBox multilinie, docat dreapta, un catalog al produselor dintr-o bază de 
date : 


private void btnCatalog Click 
{object sender, System.EventArgs e) 


{ 

‘string strSql = E EI .codp, denum; pret FROM produse"; 
OleDbConnection. con. i ze i , 
new GleDpconnection (3 


@"Provider=Microsoft: “Jet. OLEDB. a. 0; Data Source= c: Aprod. mab") 


try {con.Open(); }- 
_ catch { MessageBox.Show("Eroare open lasi agitati 7} 


OleDbCommand myCmd 


=new OleDbCommand (strSql,con) ; 


textBoxl.Text+="\r\n"+dr{"codp"]+ pel 
--'" + -dr[{"denum"]+ " costa " + dar["pret"]; 
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‘Se observă. că nu se folosesc obiecte DataAdapter sau- DataSet, ci 
doar obiecte XxxCommand şi DataReader. _ 

Pentru exemplificarea unei comenzi į 
că dorim să afişăm numărul de produse distincte, aflate în tabela produse. În 
acest scop am pus pe un buton din macheta aplicației, următoarea funcţie : 


private void btnExecScalar_Click i bn ssd 
: (object sender, System.EventArgs e) 


‘conn = new OleDbConnection ( 


@"Provider= Microsoft. Jet.OLEDB.4.0;Data Source= C: Aprod. mdb"); 


conn.Open (); 

myCommand = new OleDbCommand K 
| ae ( "SELECT COUNT(*) FROM produsa“, conn); 

int nrProd = (int 

textBox1 .Text="Numar produse comercializate: "+ nrProd; 

) f 

catch (Exception excpt) 

{ i r 


MessageBox. Show : . 
("Esec pe ExecuteScalar: "+excpt.Message); 


Un apel fost exemplificat presupunând că se 
doreşte modificarea denumirii produselor care încep cu «p»; prin 
adăugarea prefixului « txt ». Funcţia care realizează acest lucru tratează 
evenimentul click al unui buton insenpponat sugestiv: 


privates void ERE T E 
(object. sender, System.EventArgs e) 


{ 


OleDbConnection conn null; 


string ConnString = 

“Provider=Microsoft.Jet.OLEDB.4.0; "+ 

"Data Source=C:\\prod.mdb"; 

string cmd = 

"UPDATE produse SET denum = 'txt'&denum "+ 

"where denum like "psi"; 

try 
{ 
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conn = new OleDbConnectiori (ConnString);  conn.Open(); 
command = new OleDbCommand (cmd, conn); 

int 
textBox1.Text="Numar inregistrari afectate: "+ nrRec; 
) a Sar ints 

catch(Exception excpt) _ 

ry { Li ` 


MessageBox. Show 
("Esec pe ExecuteNonQuery: "+ excpt.Message); 


) 
finally 
{ 
if (conn.State == ConnectionState.Open) conn.Close(); 
} 


10. Lucru cu procedurile stocate 


Procedurile stocate sunt cereri frecvent folosite asupra unei baze de 
date, grupate sub un nume de apel. Procedurile stocate au două avantaje 
majore: 

e sunt stocate pe server si nu au nevoie să fie compuse ŞI retransmise de 
fiecare dată când sunt invocate ; 

* sunt deja compilate, fiind lansate direct în execuţie şi beneficiind deci 
şi de utilizarea statisticilor interne pentru optimizarea accesului la 
datele unei tabele. 


ae 


private void creareProc -llek (object senger; îi dd EventArgs e) 
{ i : ý ` 
string strCreare = "CREATE PROCEDURE ProdScumpe AS." . he 
+"Select * From produse where pret, > 600 Order by denum"; 
OleDbConneétion con = 
new OleDbConnection( : : 
- @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source= C: \proa. mdb" yi 
con.Open(); - ia pi ed 


OleDbCommand myCmd = new OleDbCommand (); 
myCmd.CommandType = CommandType. Text; 
myCmd.Connection = con; : 
myCmd.CommandText="DROP PROCEDURE ProdScumpe"; 


Ss Sage B OX: Show ( Procedúra de sters nu exista! ! 


myCmd.CommandText = P 
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try { dr = myCmd.ExecuteReader () ;ăâr.Close();) 
catch { MessageBox. Show ("Procedura nu a fost creata!!");} 


) 


Se set folosi diverse modalitati de a apela o spect stocată; cel mai 
simplu mod este să inlocuim instrucțiunea SELECT cu numele procedurii 
stocate: 


aţa void apelProc_Click (object sender, System.EventArgs e) 
{ i, 
OleDbConnection con = 
new OleDbConnection ( 


@"Provider=Microsoft.Jet.OLEDB.4. 0;Data Source=C:\prod. mdb"); 


con.Open(); 


OleDbCommand myCmd 
myCmd.CommandType = 
OleDbDataReader dr 
textBox1.Text="Lista produselor scump 
E()) 


DbCommand (" 


textBox1. Text+="\r\n"+dr["codp"]+ mn 
ar["denum“]+ " costa ~" + ărL“pret"]; 


Dacă procedura ar lucra cu parametri de intrare, spre exemplu n numai 
produsele cu pret peste o valoare, dată ca text într-un TextBox al formei, 

. procedura, s-ar schimba deoarece -comanda trebuie să. declare acum şi 
tri de i e / ieşire; în acest caz este nevoie să lucrăm si cu 


Aşa cum spuneam, obiectele Comand dispun de o colecție numită 

Parameters, in care prin metoda add, adăugăm parametrii pregătiți 

anterior sau furnizăm metodei informația necesară pentru: a construi ea - 
aceşti parametri: 


OleDbParameter paraml, param; ™ ™ 


,, OleDbType.Integer) ; 
n.Output; i 


param? = new OleDbParameter (" 
param2.Direction. = ParameterD 
cmdMea. Parameters .Add (param2) ; 


paraml = .cmdMea. Parameters . Add ( 
new OleDbParameter ( 


", OleDbType.Integer) ); 
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Metoda Add are mai multe versiuni supraîncărcate, în funcţie de 
numărul de argumente folosite la construirea unui obiect parametru. 

Se observă că în afara faptului că metoda a construit şi a adăugat un 
parametru de tip int la o comandă, ea returnează şi referința parametrului, 
astfel încât acesta să poată fi ulterior echipat şi cu alte proprietăți, spre 
exemplu direcția: | 


paraml.Direction = ParameterDirection. Input; 


Parametrul mai este accesibil şi prin metoda de indexare a colecției, 
care localizează un parametru după poziție sau după numele său; 
construcția de mai jos stochează drept valoare pentru parametru de intrare în 
procedură, preţul rezultat prin conversia în int a textului introdus de 


utilizator la rulare, în câmpul txtPret:. 


cmdMea . Parameters ["@PretMin") . Value 7 
Convert.ToInt32 (txtPret.Text) ; 


Sau 
cmdMea . Parameters [0] . Value = 
‘Convert. Toine 324 EEE: Text) ; 


_ In ADO.NET parametri trebuie să se numească la fel cu cei definiti 
în procedura stocată, să aibă același tip şi aceeași lungime. 


Direcția poate fi: _ 


e Input — parametru de intrare în procedură; 

e output - parametru de ieşire, returnat de procedură şi care nu poate 
conține date de intrare pentru procedură; 

e Inputoutput - parametru folosit în acelaşi timp şi pentru intrare şi. 
pentru ieşire, în comunicarea cu procedura; ae 

e  Returnvalue - parametru de ieşire, dar limitat la unul singur. 


- Pot exista mai multi parametri de tip Input, Output, Inputoutput, 
dar doar un singur parametru de tip Returnvalue. 


Funcţiile de creare, respectiv folosire a unei proceduri stocate cu 
parametru de intrare, arată acum astfel: 
private void creareProc_Click 

(object sender, System.EventArgs e) 
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cmdMea . Parameters | "GPretMin"].Value = 


{ ine 
Convert.ToInt32 (txtPret.Text); 


string strCreare = 
` “CREATE PROCEDURE ProdPestePret 
“SELECT * FROM produse WHERE pret > 


OleDbDataReader dr = null; . 


OleDbConnection con = try ( dr = 


new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;" 


Ă catch (Except: cp 
+@Data Source=C:\prod.mdb" ); { 
con.Open(); aes MessageBox. Show(excpt.Message) ; 
cg } 
OleDbCommand cmdMea =new OleDbCommand () ; textBox1.Text="Lista produselor peste "+ txtPret.Text + 


cmdMea.CommandType = CommandType. Text; " EUR \r\n\r\n"; 


emdMea.Connéction = con;: 
OleDbDataReader dr; 


textBox1.Text+="\r\n"+dr["codp"}J+ " n + 


dr {"denum* } +" woo dr["pret"]+ "n EUR"; i 
try { dr = cmdMea.ExecuteReader(); dr.Close();} . 
catch(Exception excpt) } 
{ De retinut ca parammi de ieşire sunt accesibili doar după închiderea 


MessageBox. Show ("Stergere esuata: "+ excpt.Message ); DataReader-ului. 


) 
11. Typed şi untyped DataSet 


e Typed DataSet — un DataSet care conţine şi descrierea structurii de 
- date asociată ( eventual într-o schemă XML ataşată). Pa 
„e Untyped- DataSet este cel creat la momentul execuţiei şi nu are 
ataşată o descriere a informaţiei conținută; permite crearea de obiecte 
vide, ce vor fi completate ulterior. 


_emdMea.CommandType = CommandType. Text; 


try { dr = cmdMea. ExecuteReadex();dr.Close() ;} 
catch (Exception excpt) 

{ A , : 
MessageBox.Show("Creare esuata: "+excpt.Message); 
) 


) 
Crearea unui typed DataSet sub Visual .NET 


private void apelProc_Click (object, sender, System.EventArgs e) 
‘ ; 
OleDbconnection con = "new ‘OlepbConnéetion ( 
@*Provider=Microsoft. Jet. OLEDB. 4.0;Data: Source=C: Verca. mdb" 


1. File/ Add New Item şi alegern Data Set din fereastra de dialog, punând 
apoi şi un nume de fişier (tstDataSet.xsd). 
2. În Server Explorer, dacă nu există se stabileşte conexiunea la baza de 
con. Open(); date ce conţine tabela ce vrem s-o asociem dataSet-ului ( Right Click, 
Add Connection şi se alege un provider şi o bază de date ) ; 


OleDbCommand cmdMea =" 
new OleDbCommand (" 
cmdMea . CommandType=CommandType. StoredProcedure; 


a d 3. Din Server Explorer se draghează tabela dorită peste noul fişier creat: 


anterior cu Add Item şi deschis automat în mediu. În acest moment se 


OleDbParameter parami; crează o nouă clasă cu numele stabilit de utilizator (tstDataSet ). 


paraml = cmdMea.Parameters.Add( 
new OleDbParameter ( ; OleDbType. Integer) ); 
paraml.Direction = ParameterDirection. Input; 
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În mediu va apare forma vizuală a descrierii, iar în fişierul 
tstDataSet.xsd de descriere, găsim schema XML asociată : 


<xs:element name="produse" 
xmlns:xs="http://www.w3.org/2001/XMLSchema"> 
<xs:complexType> 
<xs:sequence> ` 
<xs:element name="codp" type=x"xs:string" /> 
<xs:element name="denum" type=x"xs: string" 
minOccurs="0" /> 
<xs:element name="pret" typex"xs:double" 
minOccurs="0" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 


De altfel din bara de stare a ferestrei de afişare a fişierului se poate 
alege forma de vizualizare (DataSet sau XML). 

Lucru cu typed DataSet — ul creat mai sus este extrem de facil acum; 
este de ajuns să instantiem un obiect : 


tstDataSet ds = new tstDataSet(); 


şi vedem că el conţine ca elemente toate tabelele dragate peste acel DataSet, 
iar pentru fiecare tabelă au fost construite metode (aad 
etc.) ,au fost’ disponibilizate evenimente 
owDeleted etc.), iar structura permite 
acces rapid la orice câmp din bază, printr- un nume pus automat de către 
sistem (pretcolumn) : 


0d120",120.12); 
ToString()+" = "; 


textBox1. Text 
textBox1.Text+= 
_Gs.produse.Rows [0] [âs.produse.j 


ds .produse. |} 
-ToString(); 


Chiar lucru cu un DataAdapter este acum simplificat; este suficient 
să tragem din ToolBox un DataAdapter şi să răspundem întrebărilor puse de 
wizard si vom avea la final un adaptor de date care poale fi încărcat printr-o 
simplă comandă de Fill. 


oleDbDataAdapterl1.Fill(ds);~ 
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Pentru testare vom afişa denumirea tuturor produselor ( produsul 
existent deja în dataSet, din adăugarea anterioară, plus cele adăugate prin 
apelul F111 ): 


foreach(DataRow lin in ds.produse. Rows) 
textBox1.Textt= 


“\r\n"+lin[ds.produse. „ToString(); 


comparată cu secvența următoare unde tstDataSet.produseRow este 
văzut ca tip distinct, care are în compunere Chiar coloanele tabelei: 


W lin in ds.produse. Rows) 
\r\n"+ lin. pret; 


foreach (tstDataSet.} 
textBoxl. 
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APLICATII CU BAZE DE DATE SUB ADO.NET 


1. Legarea câmpurilor dintr-o tabelă a bazei de date cu 
- proprietățile unor controale din macheta unei aplicații 
2. Abordarea programatică a lucrului cu baze de date sub 
= ADO.NET 
3. Abordarea vizuală a lucrului cu baze de date 


1. Legarea câmpurilor dintr-o tabelă a bazei de date cu 
proprietățile unor controale din macheta unei aplicații 


După cum am văzut deja într-un capitol anterior, există două tipuri de 
legături ce se pot stabili între nişte surse de date şi diverse proprietăți ale 
unor controale: 

© - simple data binding realizată pe controale A ERE SR gen Label, 

` TextBox sau Button; se leagă doar o singură valoare (există doar una 

cum ar fi cea returnată de select Count (*) sau selectăm una din 
mai multe, valoare pe care o vom denumi SATE înregistrare 
curentă ). 

e complex data binding aea de controale bazate pe colecții: 
ListBox, ComboBox sau DataGrid, capabile să afişeze mai multe 
valori simultan. 

Ne propunem acum să vedem cum lucrează acest mecanism în cazul bazelor 
de date, atât în varianta simplă, cât şi complexă. 


Legătură simplă realizată vizual 


Spre deosebire de masive, sursele de date structurate în baze de date sunt 
vizibile și în Designer, astfel încât legările simple sau complexe se pot face 
Şi vizual. 


1. Într-o aplicație nouă C# Windows Application pi punem un textBox1 
şi un button. 

2. Vedem în Server Explorer o conexiune cu BD despre w . 
materiale si consumuri specifice. Dacă nu, se crează şi o conexiune 
în Server Explorer cu MouseRight pe Data Connections / Add si 
alegem MS Jet 4.0 ca provider, iar conexiunea trimite la fişierul 
prod.mdb. — | 
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“Tragem peste Form tabela materiale, iar pe oleDataAdapter1 pus 


3. 
automat de mediu, adăugăm proprietatea selectCommand conținând 
.. comanda: - 
d SELECT COUNT (*) AS total FROM materiale 
4. Generam  dataset-ul dataset11 folosind -RightClick pe 
_ eleDataAdapter1 + Generate DataSet - 
5. Proprietatea Text a textBox1 o legăm dinamic de variabila total 
„obţinută la umplerea - setului de date, astfel: pe Properties cu 
textBox1 selectat alegem Data Binding / Advanced și deschidem 
colecţia în care vedem posibile câmpuri de legat, dar nu şi total, 
ks căci acesta este un rezultat al execuției. i 
6.. Activăm setul de date folosind RightClick pe oleDataAdapter1 / 
Generate DataSet. 
7. Pe Properties textBox1 alegem Data Binding / Advanced şi 
deschidem colecția în care de data aceasta vedem şi câmpul total 
pe care îl selectăm ca fiind legătura pentru proprietatea Text a 
oe controlului textBoxl. 
8. Pe putton1, eveniment Click, umplem setul de date: 
să “oleDbDataAdapterl.F111 (dataSet11) ; 
„In textBox1 la rulare va apare numărul înregistrărilor citite. 
Observație. 


Prin legătură simplă se poate lega şi un element dintr-o colecție, chiar 
dacă nu defilam prin toată colecția; în acest caz se afişează implicit numai 


primul element din colecție, dar vom putea naviga prin colecție folosind un. 


obiect currencyManager, aşa cum se va vedea în subcapitolul următor. 


Legătură simple realizata prin program. 


1. 


ya 
- pe Data Connections / Add şi alegem MS Jet 4.0 ca provider, iar 


Dacă nu există, se crează baza de date prod. mdb cu tabela prodiise 
şi câmpurile codp (text), denum (text) şi pret (double). 
Eventual se crează şi o conexiune în Server Explorer cu MouseRight 


conexiunea trimite la fişierul prod.mdb 
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3. 


4. 


4 


Pe o aplicație Windows Forms se pun trei textBox-uri: tb_cod, 

tb denum şi tb_pret 

Punem în antet using System.Data. OleDb; 

Adăugăm două butoane (stânga, dreapta), pentru navigare 

Se pun în clasa Form1 doi membri referință, pentru un set de date şi 
un manager de legionai între câmpurile din machetă şi datele din 

setul de date: . 


private CurrencyManager crtManager; 
private DataSet dataSetul; 


Pe constructorul lui Form; creăm un set de date şi două string-uri, 
unul cu fraza SQL şi celălalt cu parametrii conexiunii la baza de 
date: 


dataSetul = new DataSet( ); 
string frazaSQL = 
"select codp, denum, pret from BEES 
string sirConex = “Provider= Microsoft.Jet.OLEDB.4.0;" + 
"Data Source=C: \\prod. mdb; Mis 


Sirul de conectare se poate lua cu Copy / Paste din îi ioana 
aferente conexiunii ( MouseRight în Server Explorer pe conexiune şi 
aleg Propiic ate ConnectString ). 


În continuare, tot pe constructorul lui Formi creăm un adaptor 'de 


date şi cerem umplerea setului. de date, folosind un cuplu try - 
catch pentru eventualitatea că baza de date nu se Bea: in 


directorul căutat: Ae. 


try 
OleDbDataAdapter Adaptorul = 
new. OleDbDataAdapter(frazaSQL, sirConex).; : 
Adaptorul.Fill(dataSetul, "tabela"); 
} $ 
catch i 5 = 
{ MessageBox. Show ("BD prod. map: nu este la locul ei"); o} 


Adăugăm în constructorul lui Form1 (ocara simplă a propre 
Text a celor trei TextBox-uri cu cate un câmp din tabelă : 


tb_cod.DataBindings.Add 
("Text",dataSetul.Tables["tabela"], et ui 
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„ tb_denum. DataBindings. Add A 

("Text",dataSetul. Tables ["tabela"], *denum*) ; 
tb_pret.DataBindings.Add 

ase 'dataSetut. tanlen Sabelat]y pratt); 


‘ 


- 10. ec finding - PEE elna manageru curent de 
- legături ce gestionează legăturile de.mai sus, făcute pe Sursa de date 
identificată prin dataSetul nostru : se 


` crtManager: =- (CurrencyManager) 
this. BindingContext [dataSetul. Tables["tabela"]]; 


11. Adăugăm două funcții pentru; papai înainte, pe lista pease 
curent de legături: 


protected void btn_stg_onclick(object sender, EventArgs e) 


{ 
m_lm.Position -= 1; // previous in lista manager 
} | 
protected void btn_drt_onclick(object sender, EventArgs e) 
-i : 
T .m_lm. Position += 1; // next in lista manager 


-12. Adăugăm manual codul, în InitializeComponent, pe delegatul 
corespunzător funcțiilor de tratare a apăsării pe butoane sau le 
„adăugăm vizual ca funcții de tratare Click, cu er operdes / Events, 
coreepunenor fiecărui buton: | $ 


` 


this. btn, ate. Click += 
new System.EventHandler (this. btn. eae ones ae 
this. btn_drt.Click- += 


new System. EventHandler(this.btn_drt _onclick); 


Programul sursă arată acum astfel: 


using System; . 

using System.Drawing; 

using. System.Collections; 
using System. ComponentModel ; 
_using..System.Windows.Forms; 
using System.Data; , 
using System. Data.OleDb; 


namespace BD_Binding 
{ pe 
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public class Forml : System.Windows.Forms.Form 
{ 

private CurrencyManager crtManager; 

private DataSet dataSetul; 

private System.Windows.Forms.TextBox tb_cod; 
private System.Windows.Forms.TextBox tb_denum; 
private System.Windows .Forms'. TextBox tb_pret; 
private System.Windows.Forms.Button btn_stg; 
private System.Windows.Forms.Button btn_drt; 


private System. ComponentModel .Container components=null; 


public Forml () 
{ 
InitializeComponent (); 
dataSetul = new DataSet( ); 
string frazaSQL = "select codp, denum; pret from cs udă 
string sirConex =. : 
"Provider= Microsoft. Jet. OLEDB. 4.0;" + 
"Data piei 0 Da RE Peete: 
try 
{ 
OleDbDataAdapter Adaptorul = ; 
new OleDbDataAdapter(frazaSQL, sirConex); 
Adaptorul.Fill(dataSetul, "tabela"); 
) Lu 
catch ş | 
{ MessageBox. Show ("BD prod.mdb nu este la locul: ei"); } 


// Leaga proprietatea Text a textBox-urilor de camped din BD 
tbh_cod.DataBindings.Add 
("Text",dataSetul.Tables[" ARR daia 


tb_denum. DataBindings.Add 
("Text",dataSetul. Tables ["tabela‘), "“denum") ; 


tb_pret.DataBindings.Add . m sp 
("Text",dataSetul. Tables [*tabela"}, "pret”); - 


_// cerem managerul curent al contextului de 1egaze 
crtManager = (CurrencyManager) 
i this. Bin Seng Cn Oae (oase ror ae: Dabl as tabela: 14; 
) . , Ă 


protected void btn _stg_onclick (object sender, EventArgs e) 
i  crtManager. Position -= 1; // previous in lista manager 
Be ares, void btn_drt_onclick (object sender, EventArgs e) 
crtManager.Position += 1; // next in lista manager . 


) 
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protected override void Dispose( bool disposing ) 
{ E 
if( disposing ) 

L 

. if (components != null) 
aa 

=  components.Dispose(); 
} “ 

} a 
base.Dispose( disposing ); 


} 
#region Windows Form Designer generated code 


private void InitializeComponent () 

{ 
this.tb_cod = new System.Windows.Forms. TextBox (); 
this.tb_denum =.new System.Windows.Forms.TextBox(); 
this.tb_pret = new System.Windows.Forms.TextBox(); 
this. btn_stg = new System.Windows.Forms.Button(); 
this. btn_drt = new System.Windows.Forms.Button({); 
this.SuspendLayout () ; 


/f i : pne 
this.tb_cod.Location = new System.Drawing.Point (56, 40); 
this.tb_cod.Name = "tb co"; Go 
this.tb_cod.TabIndex = 0; °°: 
this.tb_ cod. Text = "tbh cod"; 

// în Ter z 
// EP _denun 
[13 d 
this. tb_denum. Location = new Suet aa Drawing. Point (168, 40); 
this.tb_denum.Name = "tb_denum"; 
this.tb_denum.Size = new System. Drawing. size(240, 20); 
this.tb.denum.TabIndéx =-1; =o i 


this.tb_denum.Text = “tb_denum"; 
TA Sas aA 
// tb_pret 
alge s 7 rae ite 
- this.tb_pret.Location = new System.Drawing.Point(416, 40); 
this.tb_pret.Name = "tb pret"; 


this.tb_pret.Size = new System.Drawing.Size (88, 20); 
this.tb_pret.TabIndex = 2; ' 


this.tb-pret.Text = “tb pret"; 
// 
// btn_stg 
// 
this.btn_stg.Location = new System.Drawing.Point(56, 72); 
this. btn_stg.Name = "btn_stg"; 
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this. btn_stg.Size = new System.Drawing.Size(16, 23); 
this. btn_stg.TabIndex = 3; 
this. btn_stg.Text = "<"; 
this. btn_stg.Click += 
new System.EventHandler (this. btn_stg_onclick); 

// 

// btn_drt 

// 
this. btn_drt.Location = new System. Drawing. Point(80, 72); 
this. btn_drt.Name = “btn_drt"; 
this.btn_drt.Size = new System.Drawing.Size(16, 23); 
this.btn_drt.TabIndex = 4; 
this. btn_drt.Text = ">"; 
this. btn_drt.Click += 

new System.EventHandler(this.btn_drt_onclick); 

// 

// Formi 

// l 
this.AutoScaleBaseSize = new System.Drawing. Size(5, 13); 
this.ClientSize = new System.Drawing.Size(544, 333); 
this.Controls.Adâ(this.btn_ art); 
this.Controls.Add(this.btn_stg); 
this.Controls.Add(this.tb_ pret) ; 
this.Controls.Add(this.tb_denum); 
this.Controls.Add(this.tb_cod); 


this.Name = "Formi"; 
this.Text = "Exemplu legare simpla pe DataSet"; 
this. ResumeLayout (false) ; 
} 
#endregion 
[STAThread) 
static void Main() 
{ 
l Application. Run (new Forml ()); 
) 
) 
) 
Observaţii. 
e Tabela din DataSet se poate numi altfel decât tabela din BD; i-am 
` atribuit numele tabela atunci când am invocat metoda Fini ), 
aparținând adaptorului. 
e DataBinding asigură şi conversia ( pret este de tip double, iar în 
macheta apare ca text) 
Reamintim că toate controalele fiind derivate din clasa control 
moştenesc o colecție numită DataBindings de tip 
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ControlsBindingCollection; ea conține obiecte de tip Binding 
specializate în întreţinerea de legături între o proprietate a unui control şi o 
coloană dintr-o sursă de date. 


Legătură complexă realizată vizual 


Controlul de tip DataGrid se pretează cel mai. bine la afişarea datelor 
dintr-o bază de date. Vizual, legarea unui grid la o sursă bază de date se 
realizează extrem de simplu. 


1. Într-o aplicaţie C# Windows Application se aduce din ToolBox un 

control DataGrid, căruia i se stabileşte proprietatea Dock pe Fill, 
_ pentru a umple întreg formularul. 

2. Din fereastra de Server Explorer se alege o conexiune activă şi se 
draghează o tabelă peste dataGridt; efectul imediat constă în 
includerea în aplicație a două obiecte necesare lucrului cu baze de 
date: oleDbConnection1 şi oleDbDataAdapter1. 

3.  Selectând oleDbDataAdapter1, cu mouse dreapta se cere Generate 
DataSet, bifand si caseta ce solicité includerea DataSet-ului in 

“Designer. Un obiect numit dataset11 este declarat automat în 
aplicaţie şi devine vizibil în fereastra Designer. 

4. Selectând olepbDataAdapter1, cu mouse dreapta se cere Preview 
Data. 

5. Acum, încercând să stabilim vizual proprietatea Data Source a 
'gridului, găsim în lista oferită de mediu, sursa dataset11. 

6. Similar, pe proprietatea: Data Member găsim tabela produse af. să 
avem gridul deja configurat cu coloanele corespunzătoare. 


7. Nu ne mai rămâne decât ca pe constructorul formei să cerem indirect 
încărcarea gridului cu date, prin intermediul DataAdaptorului: 


this.oleDbDataAdapter1.Fill (GataSet11); 


Dezvoltări ale acestui mecanism de legare vizuală se dau în aplicația 
din finalul acestui capitol, unde se tratează și problema lucrului cu mai 
multe tabele, simultan. 


Observații. 


e La specificarea sursei de date pentru grid se precizează atât setul de date, 


cât şi tabela, sub forma: 
m_dataGridi.DataSource = ds; 
m_dataGridi.DataMember = "tbl"; 
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sau se dau simultan: 
m_dataGridi.DataSource = ds.Tables["tbl"]; 


e Controalele ce pot conţine un şir de date, pot fi legate la o sursă după 
acelaşi model, atât pentru Windows Forms, cât şi Web Forms. De 
reținut că pentru Windows Forms nu mai e nevoie să apelăm metoda 
DataBind() deoarece controalele UI implementează interfața 
IEnumerable (Său IList, Care la rândul ei se bazează pe 1Enumerable) 
Şi odată ce cunosc DataSource pot să o parcurgă. Ca sursă de date pot fi 
folosite şi DataTable, DataView, vectori, colecții etc. 

e Din codul pus automat de Designer se poate observa că obiectul 
-BindingManagerBase pointează spre un obiect de tip 
PropertyManager, când sursa de date returnează doar o valoare, 
sara CurrencyManager Când sursa de date returnează o listă de 
valori. 


2. Abordarea programatică a lucrului cu baze de date sub 
ADO.NET 


Exercitiu 


Să se scrie o aplicaţie care efectuează operațiile uzuale: încărcare, 
adăugare, modificare şi ştergere, pe tabela produse a bazei de date 
prod.mdb. Se va folosi o machetă în care este vizibilă prin data binding o 
singură înregistrare din DataSet. 


Rezolvare. 


Aplicația reuneşte într-un tot unitar cunostiintele expuse anterior, la 
discutarea fiecărui obiect folosit pentru accesul la baza de date, sub 
tehnologia ADO.NET. 

Macheta cerută ar putea arăta ca în figura de mai jos, din: care se . 
poate deduce şi care sunt controalele cu care forma a fost înzestrată. 


Funcția : © are doar rol de testare a unei conexiuni; 
ea face o deschidere şi o închidere a unei conexiuni, verificând existența 
bazei de date cu care lucrează aplicaţia. Eşuarea la deschidere e semnalată 
printr-o excepţie adecvată; închiderea unei conexiuni este bine să se facă 
testând în prealabil dacă baza este deschisă în acel moment. 
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Se fac apoi, o deschidere şi o închidere, implicite, prin intermediul 
dataAdapter-ului., 


Fig. 15.1 Macheta unei aplicații pentru operaţiile uzuale asupra unei baze de date 


private void clickDeschide (object sender, System.EventArgs e) 


{ 

string frazaSQL = “select codp, denum, pret from produse"; 

‘string sirConex = , 
“Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\\prod.mdb"; 

OleDbConnection conex = new OleDbConnection(sirConex) ; 


); .mesaj.Text="BD deschisa "; } 
catch (Exception excpt) 
{ ` : 
MessageBox.Show(“Esec la deschidere: "+ excpt.Message ); 
) . 
if (conex.State == ConnectionState.Open) 
{ conex.Close({); mesaj.Text+=" si inchisa cu succes"; } 
-m_da= new OleDbDataAdapter ) ; 
if (conex.State == ConnectionState.Closed) 


mesaj.Text+="\r\nBD redeschisa / inchisa implicit"; 
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} 


Funcția exemplifică încărcarea datelor din baza 
de date, folosind un DataAdapter; la încărcarea DataSet-ului se denumeşte şi 
tabela ( tot produse, ca şi în baza de date, fără a fi obligatoriu acelaşi nume), 
altfel am fi-identificat-o numai prin m as.rablest0];- numirea putea fi 
făcută şi ulterior, folosind proprietatea TableName a-tabelei. ` we 

La fiecare nouă încărcare a DataSet-ului se face o legatura simplă 
între trei textBox-uri şi cele trei coloane -ale tabelei produse. Pentru că nu 
ştim în ce succesiune au fost apăsate butoanele aplicaţiei, butonul Incarca 
putând fi apăsat repetat, măi întâi eventualele colecţii de legături care există 
Sunt şterse, apoi sunt refăcute. i e . À 
ca_Click (object sender, System. EventArgs e) 


private void Incar 
o | 
mds = new DataSet ("setul meu"); 

// DataSet m_ds declarat la nivel de Form. 


string frazaSQL = “select codp, denum, pret from produse"; . 
string sirConex = | pi i 
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c: \\prod.mdb"; 
m_da= new OleDbDataAdapter (frazaSQL, sirConex) ;. z 
//deschidere cu sir, nu cu conexiune; m_da declarat in Formi 


m_ds, "produse"); . f | s 
// m_âa.Fill(m_âs); m_ds . Tables [0] .TableName="prođuse" ; 


// la apasăre repetata pe Incarca trebuie sterse legaturile 
tCodp.DataBindings.Clear(); iad 
tDenum. DataBindings.Clear(); 

tPret.DataBindings.Clear(); - 


// xefacere legaturi : oa ŞI at aaa 
tCodp.DataBindings.Add("Text",m_ds.Tables[0],"codp" ); 
tDenum. DataBindings.Add("Text",m_ds.Tables[0],."denum* ); 
tPret.DataBindings.Add("Text",m_ds.Tables{0], "pret" ); 


nr_rec = m_ds.Tables[0]-.Rows.Count; 

tNrCrt.Text="1 / “+tnr_ rec; , : 
mesaj.Text="";. // afisare nume :tabela si coloanele sale 
foreach (DataTable tbl in-m_ds:Tables) : 


{ . 
mesaj.Text += tbl.TableName+ "\r\n"; N 
foreach (DataColumn col in m_ds.Tables[0].Columns} 
mesaj.Text+= "\t"+ col.ColumnName; 
} . 


string msg="";,// serie denumirile si in textBox. 
foreach(DataRow linia in m_ds.Tables[0].Rows) l 
- msg+=linia["denum"]+"\r\n"; 
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textBox1.Text= msg; 
dip 
‘Se TE apoi câini de sinteză tNrcrt, care ne arată 


numărul curent al înregistrării, faţă de total înregistrări existente. În paralel 
în câmpul de mesaje mesaj, se listează structura pe coloane a tabelei 
produse. Un textBox distinct textBox1, listează denumirile produselor, 
exemplificând astfel accesul la liniile de date ale unui DataSet.. 


Funcţia de adăugare ‘, preia datele din cele trei textBox- 
uri şi alcătuieşte un DataRow; în esenţă, funcţia n-ar avea nevoie de 
existența DataSet-ului încărcat, dar DataRow are nevoie: de o structură pe 
coloane; trebuie deci, fie să-i construim DataSet-ului colecția Datacolumns 
Columns, fie să facem o încărcare de DataSet, moment în care DataSet-ul va 
prelua structura din tabela produse, prin intermediul DataAdapter-ului; 
printr-un apel NewRow() structura este transferată şi noii linii de date. 


private void Aed Click (object sender, System.EventArgs e) 
{ = i 
string sirConex = 
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c: \\prod.mdb"; 


DataRow lin_ date= null; 
try // daca dataSet nu e incarcat 22 
(lin _date = m_ds.Tables[0].NewRow( ); ) 
| -// [0], caci,.nu stie ca se numeste produse !!. 
catch i - 
{ F 
m da= new OleDbDataAdapter ("select * from produse", 
. sirConex);//adaptor refolosit 
m_ds= new DataSet(); ; : Ler 
// daca am venit direct pe Adaugarë incarc m_ds 
(m_ds, "prođuse"}); //conexiune implicita 
lin_date = m_ds. Tables [94 


} 
if(lin_date!=null)// preluare. din textBox-uri 

{ i i . 
.lin_date["codp"] = tCodp:Text; //stie de campuri ! ! 
lin_date["denum"] = tDenum. Text; 
lin_date["pret"] = Convert.ToDouble (tPret. Text) ; 
m_ds.Tables[0].Rows.Add(lin_date); // add la dataSet 

) $ 


DataSet changes = : 

// extragem schimbarile, doar pentru a arata ca se-poate 
changes .Tables [0] .TableName= "produse"; 4 
mesaj.Text="Insereaza: rin "; 
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- foreach (DataRow lin in changes.Tables[0].Rows) 


{ 
i mesaj.Text+=lin["codp"]+"\t"; 
'“ mesaj.Textt=lin["denum"]+"\t"; 
mesaj .Text+=lin("pret"]+" rin"; 
Ve : ta Me a Gia i 


OleDbConnection myConex = new OleDbConnection(sirConex) ; 

string sirInsert = “pt a es sav ans 

“INSERT INTO produse (codp, denum, pret)” “pa dati 

i „+ " values (& . 

// luând valorile din row, are nevoie de nume simbolice 

// de parametri, pt a-i mapa pe coloanele BD i 

OleDbCommand cmd = new OleDbCommand ( sirInsert, myConex); 
// pregatire obiect comanda pentru Insert oa 

OleDbParameter param = new OleDbParameter ( ! : 

OleDbType.Char, 50, "codp" ); 


cmd. Parameters. Add (param) ; ugh we 
7 // adauga ceilalti "parametri la variabila Command 
cmd. Parameters. Add ( new! ‘OleDbParameter ( 
: . "{ f OleDbType.Char, ane "denum") ); 
w OleDbParameter ( x 
. OleDbType.Double, 8, "pret") ); 


cmd. Parameters. Add | 


m_da. InsertCommand = cmd; căi l 
i // echipeaza dataAdapter cu. proprietatea Inser tconmand 
try 

{ 


i(m_ds, “produse"); 
_ds.Tables[0].Rows.Count; 
BindingContext [m_ ds. Tables[0]]. Position = nr _rec-l; 
tNrCrt.Text = ""+ > 

( BindingContext [m ds. Tables 101]. Position+1) E dU, 
+ nr_rec; 


) 
// acelasi lucru daca. „am scrie: ber ines 
// m_da.Update (changes, "produse") ; 
catch (Exception excpt).. |. + ne 
| MessageBox. Show ("Inserare esuata: ."+ excpt .Message ye 
; hr ra 


Linia de date pregătită în acest mod, are „marcajul” de linie nouă, 
astfel încât este gata pentru a fi inserată în baza de date. În scop pur didactic, 
se testează acest lucru, separând din DataSet-ul de bază un alt DataSet 
changes, conținând doar liniile care-au suferit schimbări, în speță linia nou 


` 
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construită. Elementele acestui DataSet sunt afișate pentru confirmare, în 
zona de mesaje a aplicației. i | 

Inserarea propriu-zisă se poate face numai după ce DataAdapter-ul 
are configurată o comandă de INSERT adecvată; în acest scop se defineşte 
un obiect din clasa OleDbCommand, i se ataşează parametrii care arată cum se 
mapează simbolic valorile din linia de date peste câmpurile tabelei din baza: 
de date, după care comanda este înregistrată ca proprietate InsertCommand 
a DataAdapter-ului. eee EE Se a” Dye: 

Inserarea se face uzual pe un bloc try, asigurându-ne de potrivirea 
parametrilor cu coloanele din tabela, sau de unicitatea cheii codp, pentru 
înregistrarea nou introdusă. Concomitent, se actualizează şi afisajul de 
sumar, care spune ce înregistrare din noul total este acum cea vizibilă în 
macheta aplicației. - 


Funcţia de ştergere se asigură mai întâi că în 
momentul apăsării butonului de ştergere există stabilită o legătură între ce 
vedem în machetă şi o înregistrare din DataSet, altfel iese fără să facă nimic. 

Când legătura există, mai cere o confirmare suplimentară a operației 
de ştergere, după care pregăteşte comanda de ştergere, generând-o direct pe 
adaptor şi înzestrând-o cu cel putin un parametru, cel invocat în comandă., 

De remarcat construcţia șirului ce conține comanda de DELETE ; ea 
permite fumizarea textului din textBox între apostrofuri, pentru a respecta 
sintaxa limbajului de interogare. Sta 


private void Sterge_CLick (object sender, ‘System. EventArgs e) 
OleDbConnectio6n conex =new OleDbConnection( . A | 
“Provider=Microsoft.Jet.OLEDB. 4.0; Data Source=c: \\prod.mdb" 
v a i 4 g ro ne A Ei ); ` GQ 


if (tCodp.DataBindings.Count==0) return; 
// iese cand nu are incarcat dataset ` 


string msg = “Stergeti produsul "+ tDenum.Text+" ?"; 
if( MessageBox. Show (msg, "Stergere", 
a MessageBoxButtons.YesNo) ==DialogResult.Yes ) 
{ 


m_da. 


= new OleDbCommand ( 
DELETE from produse where denum ='* 

' +tDenum.Text¢+"'", conex ); 
=new OleDbParameter ( 
, OleDbType.Char, 50, "denum" Jz 
arameters .Add (param) ; i 


OleDbParameter pa 


m_da.DeleteComman 
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DataTable t = m ds.Tables[0]; 
DataRow.[] r = t. Select ("denum='"+tDenum. Text+"'"); 
// intre apostrofuri, altfel il cauta ca nume de coloana 


for (int i 0; i < r.Length; i++) 

(); // marcare ca sterse, in dataset 
(m_ds, "produse"); ' 
stergere si din, baza de date 


int nrs = 


if(nrs!=0) 


{ SoA: 
m_ds. (); // sterge sa reactualizeze conform BD 
m_da.Fill(m_ds,"produse"); // reincarca tot; merita ? 

// altfel facem doar 

// t.AcceptChanges (); 

A notând astfel ca s-au operat toate modificarile 
mesa] .Text="Au fost sterse "+ nrs+ " inregistrari"; 
nr_rec = m_ds.Tables[0]).Rows.Count; i 
tNrcrt.Text="1 / “+nr_rec; jae 

} . 


else mesaj.Text="Nu avem nimic de sters"; 
} toe 


// conex.Close(); 


Ştergerea se operează mai întâi. în DataSet, pentru. a marca 


înregistrările ca şterse; în acest scop se constituie un vector de referinte la 


liniile ce vor fi afectate de ştergere ( produsele cu denumirea indicată în 
TextBox-ul tDenum ), după care se aplică ştergerea fiecărei linii în parte. . 
hae Acum se poate face stergerea si in baza de date, punând de acord 
liniile de date din DataSet cu cele din tabela băzei de date, prin intermediul 
DataAdapter-ului ; se reţine şi numărul de înregistrări şterse pentru a 
actualiza anunţul din zona de. mesaje; totodată se şterge şi reumple DataSet- 
ul pentru a nota ca «originală ». starea tuturor liniilor. de date, efect 
comparabil cu cel realizat prin apelul AcceptChanges (.). . 


Modificarea unei înregistrări cade în . sarcina funcţiei 
A . $i în acest caz ne asigurăm mai întâi că modificările 
din machetă s-au făcut în contextul unor: legături existente între DataSet $i 
TextBox-urile de pe forma ( adică s-a încărcat mai întâi DatSet-ul, apoi s-a 
selectat o înregistrare care a fost şi modificată), altfel funcția se termină fără 
să facă ceva. ` Do 

In contextul modificării unor înregistrări legate la machetă 
modificările s-au răsfrânt deja asupra liniei din DataSet, astfel încât 
atribuirile din instrucțiunile comentate nu mai sunt necesare. Pot fi 
modificate doar câmpurile non-cheie (denum şi pret ); altfel se consideră fie 
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că se cere modificarea altei linii decât cea vizibilă în machetă, fie negăsind 
nici o înregistrare cu codp egal cu cel modificat nu se operează modificarea. 
Liniile modificate vor fi marcate ca «editate » după apelul 


EndEdit(). 


briyate void Modifica Click 
soe (object sender, System.EventArgs e) 


{ 
if (tCodp.DataBindings.Count= =0) return; 
// iese dac& nu are incarcat dataSet 


int poz -BindingContext [m_ds.Tables[0]} .Position; 
DataRow lin_date= m_ds.Tables[0).Rows [poz]; 
// lin_date["denum"] = tDenum. Text; 
// lin _date["pret"] = Convert. ToDouble (tPret.Text) ; 


DataTable t = m_ds.Tables[0]; 
DataRow [] r = t.Select(" +tCodp. 
// intre apostrofuri, altfel cauta ca nume de coloana 


for (int i = 0; i< fr. Length; i++) riil. EndEdit (); 
//MessageBox. Show(""+r.Length+" modif in tabela"); 
// DataSet changes = m_ ds.GetChanges(); 


OleDbConnection myConex = new olepbconnectioni 
“Provider=Microsoft.Jet.OLEDB. 4. 0;Data Source=c:\\prod. mdb" 
ee 


string 


OleDbCommand cma = - new OleDbCommand( sirupăate, myConex) ; 
// pregatire obiect comanda de modificare i 

Add (new _ OleDbParameter ( ; 

; E “OleDbType. Char, 50, "denum")); 

dd (new OleDbParameter ( 

ae ue f OleDbType.Double, 8, "pret")); 

cmd. CommandText sirUpdate; i 

: cmd;' 


` cmd. Paramete 


cmd. Paramete 


int nr = ¢ (m_ds, "produse" ); 
mesaj. Text= Au fost modificate "+ nr+ " inregistrari”; 
} 
catch(Exception excpt) 
{C | 5 
MessageBox.Show ("Modificare esuata: "+ excpt.Message ); 


) 
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Şi în acest caz, procedura. decurge tot ca şi la, celelalte operații: 
pregătirea comenzii UPDATE cu parametrii ei, ataşarea ei DataAdapter-ului 
şi lansarea comenzii prin intermediul DataAdapter-ului. Zona de mesaje 
confirmă succesul sau eşecul procedurii de modificare. l 


3. Abordarea vizuală a lucrului cu baze de date 


l Cea mai mare parte a programelor de lucru cu baze de date pot fi 
realizate şi în manieră vizuală, folosind controale specializate din ToolBox, 
wizard-uri, ferestre profilate pe vizualizarea unor conexiuni sau tabele din 
baza de date etc. i 


Aplicația anterioară oferea o legare simplă, cu vizualizarea unei 
singure înregistrări. Ne propunem acum să folosim o legare complexă 
folosind un grid, care ne permite să vizualizăm toate înregistrările unui 
DataSet. Reamintim că metoda Fi11 a unui DataAdapter permite încărcarea 
“unui DataSet cu toate înregistrările unei tabele din baza de date sau numai 
cu o parte dintre ele. 


Exercifiu 


Să se scrie o aplicaţie pentru vizualizarea şi acia datelor 
dintr-o bază de date folosind un grid. 


:; Rezolvare ` : Ba a ets 


Pentru că folosirea său măreşte partea de Heula, a “aplicaţiei, 
vom folosi în acelaşi spirit, tot maniera vizuală pentru a crea cea mai mare 
parte a codului sursă al programului: 
e crearea vizuală a unor conexiuni folosind Server Explorer; 
e preluarea din ToolBox a obiectelor de acces la baza de date 
(categoria Data) şi explorarea vizuală ă bazei de date; 
e ` Jegarea unui grid de tabelele unei baze de date, prin stabilirea vizuală 
a proprietății DataSource; : 
„e. crearea comenzilor pe dataAdapter, folosind darrean etc. 
Paşii cei mai importanți ai aplicaţiei sunt enuntati şi explicati în continuare. 


1. File / New / Othe 
specializat, care 


Projects (atenție, este un template 


); 
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» După încheierea cu succes a dialogului, în fereastra Server Explorer se 2. Cu RightClick (sau DoubleClick) pe una din tabele se poate solicita 
va observa şi: conexiunea nou stabilită: ( ACCESS.c:\"....) cu datele Retrieve Data pentru a vedea și actualiza datele din tabelă (o 
referitoare la baza de date (tabele, vizualizări, proceduri stocate etc...) deschide ca în Access, în fereastră proprie de vizualizare). Practic, 


acest tip de proiect iti asigură şi modificările tipice pe o bază.de date, 
cu salvarea noilor valori ; dispunem prin intermediul toolbar-ului sau 
a meniurilor, de diverse comenzi, inclusiv scriere de cod SQL. 


Setup and Deployment 
Othet:Projects 


Data. Connections 
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rezultatul unei cereri apăsând & 
ale datelor sau obiectelor din baza de date. 


Aplicaţii cu baze de date sub ADO.NET 
ni pCa CU Daze de date sub ADU.NEL 


_*"%=pe:DataLink Properties ( care apare automat la creare proiect sau 


poate fi cerut ulterior cu Tools / Connect to DB) se alege MS 
Access Jet 4.0 ca provider şi fişierul c:Wprod.mdb sau alt fişier ce 
conţine o bază de date creată în Access şi se stabilesc proprietățile 
corespunzătoare. É njeg 

În SQL panel din View Designer ( afişabil prin apăsarea butonului 
| ) se pot da interactiv comenzi SQL complexe, se poate vizualiza 


, sau pot fi operate modificări interactive 


i Explorer cu RightClick / Add / New Project adaugăm 
un proiec nou de tip C# / Windows Application şi schimbăm cu 
Find / Replace All, numele Form1 cu Prel_grid (în numele clasei, 
constructor, apelul Run() şi numele fişierului - Prelerid.cs). Se 
observă că pe aceeaşi Solution putem lucra cu mai multe proiecte ! 
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5. Cu drag: (ex. tabela 
produse) sau views-urile dorite peste forma din [Design]; 
operaţiunea are ca efect crearea a două obiecte oleDbconnection1 
şi oleDbDataAdapter1. În plus, se crează versiuni implicite ale 
celor patru comenzi ( SELECT, INSERT, DELETE, UPDATE ) ale 
dataAdapter-ului, cu parametrii şi direcția lor, inclusiv schema de 
mapare ( TableMappings ) a parametrilor ‘peste câmpurile 
corespunzătoare din tabela bazei de date. 


Aşadar, oleDbConnection1 conţine deja informaţiile despre provider, 
baza de date, string-ul de conectare ; oleDbDataAdapter1 conține deja 
variante inițiale pentru comenzile de Select, Update, Delete, Insert, 
modificabile dacă selectăm oleDbDataAdapterl şi în Properties pun alt 
Name, Text etc. | 


RightClick pe oleDbDataAdapter1 oferă deja trei facilități: 

a) Configure Data Adapter va lansa un wizard, dacă dorim să 
modificăm, pe paşi, proprietăţile data Adapter-ului, în speţă 
comenzile de select, Update etc. Se poate opta pentru 
QueryBuilder să configurăm vizual comenzile; acelaşi lucru 
se poate face şi cu Properties asociat obiectului DataA dapter,.- 
alegând o comandă (ex. Select), iar pe CommandText, buton 
"..." apare QueryBuilder cu care configurăm fraza select. 

b) Generate Data Set pentru a pune conditii pe setul de date 

- selectate; 
c) Preview Data pentru a vizualiza datele selectate. 


6. Generăm cu RightClick Generate Data Set şi se crează o clasă 
Dataset1 şi un obiect set de date dataseti1 pe care îl lăsăm cu 
valorile- implicite; în Solution Explorer apare un fişier 
dataset1.xsa, pe care dacă dăm click vedem descrierea câmpurilor 
preluate. l l 

7.. Se inserează din ToolBox un obiect DataGrid; îi punem proprietatea 
Layout / Dock pe mijloc (Fi11, adică umple întreaga fereastră 
formular) şi proprietatea Data source pe dataset1. Pe proprietatea 
Data Member selectăm tabela produse a.i. la rulare să avem gridul 
deja expandat. Se pot pune şi alte proprietăți, dar mai puţin 
importante : CaptionText,-CaptionVisible etc. Se putea alege ca 
proprietate Data Source direct obiectul dataset 11. 
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8. Pe constructorul formei se cere încărcarea setului de date în grid: 
oleDbDataAdapter] .Fill (dataset11); 


9. Dacă a “eşuat crearea implicită a comenzilor Inserv/Delete/Update 
(vezi pas 5). creăm . noi aceste comenzi punându-le cu editorul pe 
proprietățile InsertCommand, DeleteCommand şi respectiv 
‘UpdateCommand ale obiectului ol eDbDataAdapter1: mai întâi fixăm 
Connection pe conexiunea. existentă, apoi. pe CommandText Cu 
QueryBuilder configurăm comenzile astfel: 


INSERT INTO produse (codp, denum, pret) 
VALUES . (?, ?, ?) 
DELETE FROM produse WHERE (codp = ?) 
UPDATE produse SET denum = ?, pret = ? WHERE (codp =?) 


10. Adăugăm un meniu (din Toolbox) cu opțiunile : salvare Şi Iesire. 
Pe evenimentul click al opțiunii de salvare punem o funcție cu 


codul: 
try 

to : - i 
- DataSet schimbat = dataSet11:GetChanges(); 


if (schimbat!=null) 
int onlin =oleDbDataAdapterl.Update(schimbat) ; 
dataSet1l.AcceptChahges () ; 

- MessageBox. Show ("Salvat "+nlin+" linii de date"); 


} i 


{MessageBox Show ("Nimic de salvat ga) 
catch (Exception: eroare) 

Doe i, Bd ae ez h: , ; 

. MessageBox. Show ( "Eroarea: "+ eroare.Message ); 
l Gataset11l.RejectChanges () ; i 


UI. -Pe evenimentul click al opțiunii Iesire punem o funcţie cu codul: 
. ie ocr Exit(); 


ry 


Putem acum testa, la rulare inserând, modificând sau ştergând una sau mai 
multe înregistrări şi mutăm mouse-ul pe o altă linie; la opțiunea salvare, 
ni se afişează câte linii au fost salvate sau eventualele erori de salvare. 
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Aducând în grid mai multe tabele între care există deja stabilite 
relaţii, gridul oferă posibilitatea navigării în profunzime, pe aceste relații. 


Lucru în grid cu DataSet-uri cu mai multe tabele de date corelate 


Ne punem problema cât de uşor putem programa vizual, folosind un 
grid în care să vedem date provenind din mai multe tabele, corelate între ele. 
Să presupunem că dorim să. scriem un program. de actualizare a 
consumurilor specifice. Operatorul nu se poate descurca dacă lucrează doar 
pe tabela de consumuri, pentru că nu ştie pe de rost coduri de produse şi de 
materiale pentru a modifica în cunoştinţă de cauză un consum specific. 
Trebuie aşadar să aducem în grid şi denumirile în clar, preluate din tabelele 
produse şi materiale. 

Pentru aceasta nu avem decât ca într-o aplicaţie Windows C# simplă 
să parcurgem paşii următori: i 


1. inserăm un DataGrid 

2. dragăm o tabelă dintr-o bază de date vizibilă în Server Explorer 

3. penerăm. un dataSet selectând oleDbDataAdapter1 şi folosind 
mouse RightClick 

4. legăm gridul de dataset1 prin intermediul proprietagii DataSource 
a gridului 

5. cu oleDbDataAdapter1 selectat, modificăm P E 


SELECT produse .denum, materiale. denm, consumuri.codp, 
consumuri.codm, consumuri.consum 
FROM ((produse INNER JOIN consumuri 


ON produse.codp = consumuri.codp ) 
INNER JOIN materiale a 3 
ON consumuri.codm = materiale.codm ) 
ORDER BY produse. đenum 


289. 


Aplicaţii cu baze de date sub ADO.NET 


6. Pe constructor sau pe Load_Form se cere inc4rcarea DataSet-ului: 
oleDbDataAdapterl.Fill(dataSet11,"mixta"); ` 


7. Optiune Save a meniului va conţine acum codul: 
private void Save_Click(object sender, System.EventArgs e) 
{ 


try 
{ A 
oleDbDataAdapteri . Update (dataset11, "mixta"); 


) 


cateh( Exception exc) 


{ 


MessageBox. Show ("Esec update "+exc.Message) ; 


) 


8. Pe proprietăţile obiectului  oleDbDataAdapteri,  modificăm 
comanda - de Update pentru a opera doar pe consumuri, 
modificându-le conform modificărilor făcute de utilizator în grid : 


UPDATE consumuri j A 
SET codp = ?, codm = ?, consum = ? 
"WHERE (codp = ?) AND (codm = ?) i 


9. După aceasta. se regenerează de fiecare dată' datasetii ( 
oleDbDataAdapter1 selectat şi MouseRight / Generate DataSet ). 


Se observă că în astfel de situații mediul numai ştie să genereze 
automat comenzile de lucru cu baza de date. Putem da comanda select într-o 
formă primară, mult mai apropiată de utilizator: 


SELECT: ; produse.denum, materiale.denm, consumuri.consum 
FROM produse, materiale, consumuri 
WHERE produse. codp = consumuri. codp AND. 


consumuri .codm = materiale.codm 
ORDER BY produse. denum 


dar ea va fi înlocuită automat, la compilare, cu forma standard cu INNER 
JOIN, aşa cum apare în secvența de program de la pasul 5. 
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CONTROALE DE UTILIZATOR 


1. Construirea şi testarea controalelor de utilizator 
2. Construirea bibliotecilor de componente utilizator 


1. Construirea şi testarea controalelor de utilizator 


Prin control de utilizator înțelegem o componentă cu o anumită 
funcționalitate construită de programator şi bazată uzual pe o formă, stocată 


„într-o bibliotecă dinamică (dll), care poate fi inserată în ToolBox de unde 


poate fi preluată cu uşurinţă şi folosită în diverse alte aplicaţii. 


Exercitiu 
Să se creeze un control de utilizator « Ceas programabil » care oferă 
următoarea funcționalitate: , í 
„je poate fi programat să sune la o anumită oră şi minut; 
e poate bloca tastatura, dacă la momentul fixării cuantei de timp 
cronometrate s-a optat pentru această opțiune. 


Să se testeze un astfel de control într-o aplicație de examinare, bazată pe 
testgrilă. o: 


Rezolvare 


1. File/ New / Project şi se alege Windows Control Library ca template 
de aplicaţie. Apare o formă'cu nume implicit UserControl 1, pe care îl 
putem schimba după dorință; noi cu Find / Replace.vom schimba 
UserControll cu CeasCtri şi pentru a 0 referi uşor în continuare 
ŞI pentru a o distinge mai departe de forma principală a aplicaţiei client 
ce foloseşte ceasul drept control. oe su 


Preferabil să alegem pentru fereastra vii i stingă 
a viitorului control un stil : 
FormBorderStyle SizableToolWindow. ` i : pa 


2. Prin aducerea unui control Timer din ToolBox, sau scriind direct cod 
sursa, realizam instantierea unui obiect Timer, căruia i se stabilesc 
principalele proprietăți ( Interval 1000, intervalul la care să ticăie — o 
secundă, Enabled true, adică timer activat); dacă am lucrat vizual (cu 
designer-ul), în acest moment avem: 

e în definiția clasei Céasctrl, declaratia: 
private System.Windows.Forms. Timer timer1; 
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e jarin InitializeComponent(): 


this.timerl = 
new System.Windows.Forms.Timer(this.components) ; 
this.timerl.Enabled = true; 
this.timerl.Interval = 1000; 
// this.timerl.Start(); 


this.Name = “CeasCtrl"; 


Cu controlul timer1 selectat, se crează cu Properties / secţiunea Events 
şi apoi se înregistrează automat funcţia de tratare a evenimentului 
Tick: 


this.timer]l.Tick += 
new System. EventHandler (this.timerl_Tick); 


Cu fornia CeasCtrl selectată, se crează cu Properties / secţiunea 
Events şi apoi se înregistrează funcţia de tratare a evenimentului 
Paint al formei, pentru că avem nevoie ca la fiecare secundă să se 
retraseze ceasul, cu poziţia acelor actualizată. 


this.Paint += f 
new PaintEventHandler (this. CeasCtrl_Paint); 


Declarăm forma drept retrasabilă la redimensionare, punând in 
constructorul ei proprietatea ResizeRedraw pe true: 


this. ResizeRedraw = true; 


Se adaugă în definiția clasei Ceasctrl trei variabile « ce vor ţine 


coordonatele temporale: 
public int ora,min,sec; 


- Se scrie efectiv. funcția de tratare a evenimentul Paint, astfel încât să 


traseze secundarul, minutarul şi orarul, la un unghi proporțional cu 
secunda, minutul şi ora exactă : 


private void CeasCtrl paint 


{ 


{object sender, System. Windows. Forms. PaintEventArgs e) 


int i; 
SolidBrush 
pnsRosie = 
new SolidBrush(Color.FromArgb(120, 255, 0, 0)), 
pnsNeagra = 
new SolidBrush (Color. Fromârgb (120, 0, 0, 0)), 
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pnsAlbastra = i A 
new SolidBrush (Color.FromArgb (120, 0, 0, 255) ); 


Pen penSec 
penMin 
penora 


new Pen(pnsNeagra,1), 
new Pen(pnsAlbastra,2), 
new Pen(pnsRosie, 4) ; 


Pen pen = new PenlpnsRosie,3); 

Rectangle rect = e.ClipRectangle; 

rect.X+=5; rect.Y+=5; rect.Height-=10; rect.Width-=10; 
// dreptunghi de vizualizare 

int Raza = rect.Height/2-10; 

Graphics g = e.Graphics; 

g.DrawEllipse(pen,rect); 

int x0 = rect.X+= rect.Width/2; 

int yO=rect.y+=rect.Height/2; 

cerculet (x0,y0,5,g); 


for(i=0; î<12; i++) // cadranul 


{ 
int x, y; 
x=x0+ (int) (Raza*Math.Cos(i*Math.PI/6.0)); 
y=y0- (int) (Raza*Math.Sin(i*Math.PI/6.0)); 
i ie ee Ye 8 9); 
) 
Point | centru = new cn Guy, 


capSec = new Point 
x0+ (int) (Raza*Math.Cos (Math. PI/2-sec*Math. PI/30.0)) 
y0- (int) (Raza*Math. Sin (Math. PI/2- sec*Math. PI/30.0)) 
ya 
g.DrawLine (penSec, centru, capSec); 


Point capMin = new Point 
x0+ (int) ((Raza-15)*Math.Cos (Math.P1/2- 
- ({mint+sec/60.0)*Math.PI/30.0)), 
y0- (int) ((Raza-15) *Math.Sin (Math. PI/2- 
$ (min+sec/60. 0) *Math. PI/30. 0)) 
g. ARN pein: centru, capMin); 


Point capOra=new Point ( 
x0+ (int) ((Raza-30) *Math. Cos (Math. PI/2- 
(ora+min/60.0) *Math.P1/6. 0)), 
(int) ((Raza-30) *Math. Sin (Math.PI/2- ... 
(ora+min/60.0) *Math:PI/6. 0)) 
g.DrawLine (penOra, centru, capOra) ; 


} 


Se completează clasa Ceasctri cu două funcţii auxiliare, necesare 
trasării cadranului ceasului: ; 


void cerculet (int x, int y, int raza, Graphics g) 


{ // cerculet cu centru si raza date 
Rectangle r = new Rectangle 
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(new Point (x-raza,y-raza), new Size (2*raza,2*raza))7 
Brush pens = new SolidBrush (Color. Red); 
g.PillEllipse (pens, r); 
} 


void patratel (int x, int y, int latura, Graphics g) 
{ // patratel dat prin centru si latura sa 
Rectangle r = new Rectangle | i 
new Point (x-latura/2,y-latura/2), 
new Size(latura, latura) ); 


SolidBrush pns = 
new soliaBrush (Color. FromArgb (120, 0, 0, 255)); 


Pen pen = new Pen(pns,2); 
g.DrawRectangle (pen,r) ; 


) 


8. Se completează funcția de tratare a evenimentului Tick astfel încât după 
preluarea timpului ca string să extragă ora, minutul şi secunda şi să le 
stocheze ca întregi, în variabilele alocate anterior la nivelul formei: 


private void timer1_Tick (object sender, System.EventArgs e) 


{ 


string strOra = DateTime .Now.ToLongTimeString () ; 
// similar cu a prelua direct DateTime.Now.Hour --- 


if (strOra[1 S25) 


{. l ; 

a ora = convert . ToInt32 (strora. Substring (0,1) ); 
min = Convert . ToInt32(strora.Substring(2,2)); 
sec=Convert .ToInt32(strora.Substring(5,2))j 

} E 

else 

{ ki 2 
ora = Convert .ToInt32(strOra.Substring(0,2)); 
min = Convert. ToInt32 (strOra. Substring (3,2)); 
sec=Convert.ToInt32(strOra.Substring(6,2)); 

y : 


this.Invalidate(); 
} i 


9. Se adaugă în clasa ceasctrl două variabile ce tin ora şi minutul la care 
este programat ceasul să sune: i . 


private int sunaora, sunaMin; 


pe care le initializam cu 0, în constructorul clasei. 
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10. Adăugarea "proprietăţilor SunaLaOra şi SunaLaMin controlului de tip 

ceas; prin acestea, aplicaţia client va putea fixa 1 mi 
i , t ora $i minutul la 
doreşte să sune ceasul. i ia 
i ClassView RightClick pe forma ceasctr1; alegem Add / Add 
roperty şi completăm numele proprietăților şi i i 

Proper | şi conținutul acce 
încât să arate astfel: j tăi 


public int SunaLaOra | 
{ 
get { return sunaOra; } 
set { sunaOra = value; } 


) . 
public int SunaLaMin 


get { return sunaMin; } 
set { ` sunaMin = value; ) 


[Browsable (true), ; 
EditorBrowsable (EditorBrowsableState.Never) 
Category("Custom")] i ‘ 


i Atributul EditorBrowsableState.Never de mai sus se adaugă doar 
dacă vrem ca proprietatea să nu fie vizibilă în editorul de proprietăți. 


i Nu trebuie să ne impacientăm că nu vedem încă proprietățile 
controlului ceas în fereastra de proprietăți. În editor nu se văd pro rietatil 
decât pentru clasele terminate; adică putem vedea doar “topical ane! 
clase de baza, nu ale celei pe care o derivam acum $i este deocamdată î 
construcție. Vom vedea proprietăţile acesteia abia când o vom folosi za | 
aplicaţie client. Spre exemplu, în orice aplicație vedem proprietăţile ep 
dar este vorba de clasa de bază Form, nu de cea derivată de noi dir i 
denumită implicit Form1. Sr i Hai 

Se denumesc prin proprietăți de ambient (de exemplu BackColor, 


ForeColor, Font) proprietăţile ale căror valori dacă nu le definim noi, ele 
? 


11. Creare aplicatiei de testare a controlului de utilizator 


Inca de la început, observăm că aplicaţia se compilează, dar nu rulează 


| direct, ci avem nevoie de o aplicaţie care să folosească acest control 
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Solution permite să avem în acelaşi timp mai multe proiecte deschise 
într-o sesiune; putem deci lucra concomitent pe controlul nostru şi verifica 
efectul modificărilor în aplicaţia care îl va utiliza. Solution permite aşadar şi 
depanarea multiproiect. 

e Meniu File , Add + New Project şi se alege de această dată, C# 
Windows Application pe care îl vom denumi TestareCeas; 

e meniu Project / Set as Startup Project; stabileşte că acest proiect se va 
lansa primul în cadrul acestei soluții; în felul acesta putem lucra încă pe 
controlul de utilizator, iar mediul va lansa mereu aplicaţia de test cu 
noua variantă a controlului, deja înglobată. 


12. Adăugarea controlului de tip ceas în ToolBox-ul aplicaţiei client. 


În noul proiect, pe meniu Tools / Add Remove ToolBox Items putem 
adăuga Framework Components, COM-uri sau alegând Browse cautăm 
directorul care conţine Ceas.dll, creat anterior; după inserare vom găsi deja 
în ToolBox, de obicei în secțiunea My User Controls, controlul CeasCtrl 
_ creat de noi anterior. 


13. Aducerea controlului pe forma TestareCeas prin tragere din ToolBox 
ne dezvăluie un lucru extrem. de important: prin inserarea controlului, 
acesta este instantiat şi începe să funcționeze, chiar dacă aplicația 
client “nu este încă în execuţie. Acest lucru este carcteristic 

- componentelor, ele având existență de sine stătătoare, dialogând cu 
aplicaţia client ca de la executabil la executabil. > 


14. Adăugarea unui eveniment pe controlul de utilizator 


e În partea de început a clasei ceasctr1, unde sunt declarați şi ceilalți 
membri ai clasei se scrie: 


"public event System.EventHandler Suna; 


“e La rulare; se vede deja în fereastra Properties / Events a clasei 
client, selectând controlul ceasctr1 tras din ToolBox, evenimentul 
numit suna, iar aplicația de test poate subscrie la acest eveniment. 


15. Subscrierea formei -client la eveniment prin înregistrarea unei 
funcţii de tratare a mesajului emis de evenimentul suna se poate face 
în manieră vizuălă sau scriind codul sursă. Putem da double click pe 
acest eveniment şi se crează automat funcția : 
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` 


private void ceasctrll_ Suna r l f 
| (object sender, System.EventArgs e) { } 


O vom completa pentru simplitate, 'să scrie timp de un minut textul 
« Suna ceasul » într-un textBox cu proprietatea Multiline pe true, adăugat 
în prealabil pe forma aplicaţiei client : 


private void ceasCtrl1_Suna 
(object sender, System.EventArgs e) 


{ 

; textBox1-Text+="\r\nSuna ceasul"; 

} 

Singura problemă rămasă este cine declanşează evenimentul suna : 

N 4 “aA mă ` . i a 2 

pentru aceasta am adăugat in finalul funcţiei de tratare a evenimentului 
Tick în Ceasctr1 apelul: | 


if (ora==this.sunaOra && Suna!=null ) 
j if (min==this.SunaLaMin); | _ ăi i 
Suna (this, new EventArgs () ) ;. 


Lansarea evenimentului se face doar dacă delegatul conține vreo 
metodă ataşată de aplicația client (Suna!=nul1); altfel, controlul static din 
aplicația client rulând încă înainte de a rula aplicația client, va declanşa 
evenimentul, dar delegatul neavând ataşată încă metodă va da excepţie de 
referință nulă. l Dă ie Alp eta 


Dacă înainte de a lansa aplicația client avem grijă să fixăm 
controlului ceas proprietăţile sunaLaora şi sunaLaMin pe valorile: 13 şi 38 
sau 1 şi 38, adică în format lung sau scurt după cum este setat să afişeze şi 
ceasul din Windows și apoi lansăm aplicaţia, la ora şi minutul respectiv 
ceasul va suna ! l dy A A a. 


Suna ceasul 
Sună ceasul ..: 
Suna ceasul 


Suna ceasul: 
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Pentru a răspunde ultimei cerințe, legată de blocarea tastaturii la 
atingerea momentului critic vă sugerăm folosirea celor discutate în capitolul 
Gestiunea evenimentelor generate de tastatură , în speta.e.Handled=true; 
din blocul de parametri ai evenimentului KeyPress. 


2. Construirea bibliotecilor de componente utilizator 


Am văzut deja cum se construieşte o componentă de utilizator şi 
cum este ea integrată într-o aplicaţie client. În mare parte lucru s-a 
desfăşurat în manieră vizuală, iar componenta de utilizator a fost înzestrată 
cu interfață vizuală, pentru a fi uşor pro gramabilă $i manipulabilă. 

ml principiu, este posibilă şi crearea de componente fără interfață 
vizuală, stocabile tot în biblioteci dinamice şi care oferă clase si funcții cu 
oarecare generalitate, utile în alte aplicaţii. Pentru a putea face comparații, 
am realizat aproximativ aceeaşi componentă şi în versiunea cu interfață 
vizuală, subliniind astfel mai bine diferențele. 


Componente fără interfață vizuală 


Vă prezentăm modul în care programatorul poate să-şi construiască 
un domeniu de nume (namespace) în care să-şi definească clase, pe care 
ulterior le va folosi în alte aplicaţii. 


I. Constiirek bibliotecii de ince presupune AA urmatontet pasi: 


1. Se onsu un nou proiect File / New / Project si se va alege la 
Project Types Visual C# Project, iar la Templates Class Library, 
numele dat de programator fiind Bib1; ( a se observa că template-ul 
diferă de cazul anterior, când era Windows Control Library ) 

2. Pentru. implementare trebuie să" stabilim în prealabil * funcționalitatea 

„clasei; Spre. exemplificare, definim spațiul de nume statistic şi 
implementăm clasa colectivitate pentru a caracteriza o colectivitate 
Statistică cu ajutorul indicatorilor: medie, dispersie şi coeficient de 
variaţie. Formulele de calcul sunt: 


- media aritmetică:  m=->—, 
n 
unde x; reprezinta observaţiile şi n numărul de observaţii; 
i 298 


oo mir ti ii Rite i nt: iati eat n anaa 2 ie idea E E RF EEE VEL în 


inte F LAESA Aa Di mata ao: 


Controale de utilizator 


- dispersia: _ o == 


-. coeficientul de variație: cv = IOa 
m 


Vom completa fişierul Bib1.cs după cum urmează: 


using System; 
namespace Statistic 


{ 
public class Colectivitate 
{ 
// sectiunea privata 
int no; // numarul de observatii 
bool vb; // flag - daca indicatorii sunt calculati 
int[] vo = new int[100]; // vectorul de observatii 


double m,d,cv; '// medie, dispersie si coef. de variatie 


//calcul medie 
void c_med() 
{ A 
double s=0.0; 
for(int i=0; i<no; i++) St=vo[iJ; 
try : i 
{ 
if (no==0) throw new Exception () ; 
i m=s/no; 
) 
catch (Exception) 
{ 
Console. WriteLine("\n\tImpartire lā ZERO! ! 
\n\tColectivitate fara observatii!!"); 
Console.Read(); 
Environment.Exit (1); 


) 


//calcul dispersie 
void c_disp() 


{ 
double s=0.0;. 
for(int i=0; i<no; i++) s+=(vo[i]-m)*(vof[i]-m); 
d=s/no; ‘ 
} 


//calcul coeficient de variatie 
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void c_cv() { ev=Math.Sqrt(d)/m; ` ‘4 
//ealcul indicatori | 
void calcul () { c_med();.c_disp(); cicv(); } 


//sectiunea publica 
//constructori - 
public Colectivitate() ( no=0; vb=true; } 
public Colectivitate(int k) { no=k; vb=true; } 


//adaugarea unei observatii la colectivitate l 
public void Add(int z) { vo[no++]=z; vb=true; } 


//citirea de la tastatura a observatiilor 
public void citire() 
{ $ 
for(int i=0;i<no; i++) 
{ . | 
Console.Write("Observatia (0) =",i+1); 
voli]=Convert.ToInt32 (Console.ReadLine()); 


} 


//conversia rezultatelor la sir 
public override string ToString() 
{ 
if(vb){ calcul(); vb=false; } 
return " Media="+m.ToString("F")+" 
Dispersia="+d.ToString("F")+ 
" Coeficient de variatie="tcv.ToString("F"); 


) 


//proprietati 
public double media 


{ 


//media - read onlz (calculat) 


` get 

{ l j i 
if(vb){ calcul (); vb=false; } 
return m; 


} 


public double dispersia //dispersia -. read only (calculat) 
{ 
get 


{ 
if(vb){ calcul); vb=false; ) 


return d; 
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public double coef_variatie //read only (calculat) 
{ 
get 
{ 
if(vb){ calcul(); vb=false; } 
return cv; 


) 


/faccesul la observatii prin indexare: 
public int this [int i] 


{ 

get 

{ : 
if (i < 0 || i >= no) return 0; 
else return vo[i]; 

} 

set 

{ 
if (!(i < 0 || i >= no)) 

{vb=true; voli] = value; } 
) 


Prin opțiunile meniului Build / Build Solution se obţine fişierul 


bib1.d11 care va conţine biblioteca de clase. 


II. Utilizarea claselor din biblioteci în aplicaţii independente presupune 


efectuarea paşilor următori: 


1. 


Ww 


Construirea unui nou proiect File / New 7 Project pentru care se va 
alege la Project Types Visual C# Project, iar la Templates Console 
Application, numele fiind rest Bib; | | 

Se vizualizează fereastra Solution Explorer ( View / Solution Explorer ) 
Se deschide controlul de tip tree care are rădăcina restBib şi o ramură 
References; a 

Se selectează References, se dă click pe butonul dreapta mouse şi se 
alege Add References; 

In căsuţa de dialog se selectează Projects după care se apasă pe butonul 
Browse şi se alege fişierul Bib1.ă11 care conţine biblioteca dorită; în 
urma operației, la References va apare şi Bib1; 

In program, înainte de. a folosi, clasa colectivitate, trebuie să se 


invoce spaţiul de nume statistic: 
using Statistic; 
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Renee de tite 


a clu aa Engst Dalen Bi cant 
Programul care utilizează biblioteca creată anterior poate ave 

structura următoare: 

using System; 


using Statistic; 
class Principal 


{ . 

static void Main(string[] args) 

i "1 olectivitate (3) 

tate cl = new Colectivi te (3), | 
tie fa c2 = new colectivitate); 
cl.citire(); 
i 1 te: {0}",c1); 

Console.Write ( Rezulta eee 
Console.Write("\n Adaugati o noua gbservatie ); 
int „=Convezrt . ToInt32 (Console.ReadLine()); 
cl. Add (x); | l 
Console.Write("Noile rezultate: {0} „cl); 

„Write za , p 
pl ii RE 1: {0} Modificati val:",c1[0]); 
xeconvert .ToInt32 (Console.ReadLine()); 
c1[0]=x; , f l 
Console. Write ("Media recalculata: {0}",cl.media) ; 

„Write ae : : 
iati ("\nRezultate colectivitate fara obs: {0}",c2); 
Console.Read(); 

} ie 
} 


Componente cu interfata vizuala 


i e utilizator 
„Crearea unei componente de uti! ) > Ng 
: Tot în vederea caracterizării unel colectivităţi statistice cu clipe 
ace “yng ` - e . . za o 
indicatorilor medie, dispersie: $1 coeficient de oe se = : = 
i ă vizuală ca î ătoare. Ca modalite 
ă vizuală ca în figura urmåtoare. € n 
componenta cu interfață. vi es 
$ nică ita ŞI a CeasCtrl, Cr 
i i ită şi pentru componen i 
folosi aceeaşi tehnică folos i azi ie 
anterior; micile deosebiri arata diverse alternative pentru a realiza acelaş 
, x 


lucru. 
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1. Se construieşte un nou proiect File / New / Project şi se va alege la 


Project Types Visual C# Project, iar la Templates Windows Control 
Library, numele fiind comp_viz; 

2. Se generează, pentru a implementa operaţiile ce tin de interfaţă, o clasă 
denumită în cazul nostru Indicatori, după cum urmează: i 


public class Indicatori : System.Windows.Forms.UserControl 


3. Se va completa vizual forma, care va constitui interfaţa vizuală, cu 
controalele, ca în figura amintită; 

4. Se adaugă la proiect o nouă clasă (Project / Add Class), numele fiind 
Colectivitate, pentru a implementa efectiv partea de calcul a 
indicatorilor ( clasă este descrisă ca în exemplul anterior ). 


Pe forma componentei există controale cu rol în introducerea, 
modificarea respectiv ştergerea observaţiilor şi controale de tip TextBox cu 
rol în afişarea rezultatelor. Controalelor de tip TextBox, pentru a nu le 
permite editarea valorii, li s-a asociat proprietăţii Readon1y valoarea True. 

e Introducerea datelor (observațiilor) se realizează printr-un control de 
tip ComboBox (cB1) pentru care proprietatea de DropDownList este 
simple. In casuta de editare se vor introduce valori care vor fi adăugate 
în listă prin apăsarea tastei ENTER; acest lucru se face raspunzind la 
mesajul KeyUp: 


private void cB1_KeyUp(object sender, KeyEventArgs e) 
( À 
if (e.KeyData==Keys.Enter) 


{ 
cB1l.Items.Add(cB1.Text); // adaugare text in combo 
cB1.Text="0"; // xeinitializare zona editare 
cB1.Select (0,1); // selectie continut. zona 
//de editare 
) 


) 


e Modificarea valorii unei observaţii presupune mai întîi selectarea ei din 
lista de observaţii; se răspunde la mesajul selectedIndexChanged 
pentru controlul de tip comboBox: 


private void cBi_SelectedIndexChanged 
(object sender, System.EventArgs e) 


{ 
idx = cBl1.SelectedIndex; 
) 


303 


Controale de utilizator 


3 r 


X. 


ă a Ci apasa pe butonul 
ComboBox, se editează corespunzător după care = o p 
f p F p a: 
inscripționat Modifica valoare, care declanşează funcția 
1 $ 


V j Y . ntArgs e) 
j vate oid buttoni Click (ob ect sender, System.Eve g 
pr: 


{ 
if(idx!=-1) 


string sir=cBl.Text; 


cBl.Items [idx] esir; 
cBl. Focus (); 
} 


ener B Show ( k 
ox. l A ȘI ja, 
E oen selectata valoare pentru modificare 


"Mesaj de eroare",MessageBoxButtons. OK, 
MessageBoxIcon. Warning ); 


ii ai întîi selectarea ei 
Ștergerea valorii unei observații presupune mai întîi sel , 
inscripti re: 
după care se apasă butonul inscripționat Sterge Valoa 


te voi ' Y em. Event. rgs ) 
va b ende S 
p d button3 Click (o e 
EL ect ser r S t E A 
idx=cBl1.SelectedIndex; 

if (iax!= 1) 


i cB1.Items.RemoveAt (idx); 


cB1.Text="0"; 
cB1.Select (0,1); 


) 


ici Box. Show ( Și 
Ox. l i 
Me ae selectata valoare pentru stergere!", 


= uttons.OK 
"Mesaj de eroare eer cama ; 
MessageBoxIcon.Warning ; 


| i ăsare: inscripționat 
Afişarea rezultatelor se face prin apăsarea pe butonul inscript 


Afisare rezultata >> 


va vV o c c object e e Y . ventArgs e) . 
pr i te oid button2 Li k ( b send r; System. E 
fm 


{ 


int[] vobsi=new int{cB1l.Items.Count]; 
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for(int i=0;i<cB1.Items.count; i++) 


roa ane coonvert.ToInt32 (cll. Ttema (17), 
¢.dnearca_obs (vobsi) ; 


pextBoxl .Text=c.media.ToString(*P*) 
cetei. Textec. disperata. Tostring ("F"); 


PERONI Texte. coat variatie. Tostring ip), 
) : 


unde, c este o variabilă membră a clasei Indicatori de tip Colectivitate. 


Metoda incarca_obs() a clasei 
încărcarea observațiilor din ComboBox în 
Colectivitate. 

La nivelul clasei Indicatori s-au defi 
obținerea valorilor indicatorilor, a numărului de 


Colectivitate ale ca scop 
vectorul de observaţii al clasei 


nit şi Proprietățile pentru 
observaţii şi a observaţiilor: 


public double media 


{ 
get 
{ 
return c.media; 
je 
) 
public int this [int 1]: ‘//acces la © observatie individuala 
{ | i 
get 
{ 
if (i<0||i seg Nr_obs) return 0 
else return cli]; 
} 


} 


public int numar obs 
{ 
get 
{ 


return c.Nr_obs; 
} 


Aceste metode au ca Scop: mărirea flexibilitatii Controlului în cazul în 


care acesta se integrează în alte aplicaţii. 


Prin Build / Build Solution se obține fişierul TO care 


conține componenta cu interfață vizuală, 
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II. Utilizarea componentei cu interfață vizuală creată anterior într-o 
aplicaţie independentă presupune efectuarea următorilor paşi: 


1. 


ve e 


10. 


Construirea unui nou proiect File / New / Project şi se va alege la 
Project Types -Visual C# Project, iar la Templates Windows 
Application, numele fiind test_comp_viz; 

Se vizualizează fereastra Solution Explorer ( View / Solution 
Explorer ); 


Se deschide controlul de tip tree care are rădăcina test_comp_viz şi 


0 ramura References; 


„Se selectează References, click pe butonul demai mouse şi se 
‘alege Add References; 


In casuta de dialog. se selectează Projects după care se apasă pe 
butonul Browse şi se alege fişierul Comp_viz.â11 care conține 
biblioteca dorită; în urma operaţiei, la References va apare şi 
Comp_viz; 

Se vizualizează fereastra Toolbox, se selectează secțiunea General, 
click pe butonul dreapta mouse şi se alege opțiunea Customize 
Toolbox; 

In căsuţa de dialog Customize Toolbox, se selectează .NET 
Frameworks Components; 

Se apasă butonul Browse şi se deschide fişierul comp_viz.d11; 

In controlul ListView va. apare articolul Indicatori care trebuie 


bifat, după care se apasă butonul OK pentru confirmare şi terminarea 


dialogului; 
In secțiunea General a ferestrei Toolbox trebuie să apară articolul 
Indicatori pentru a putea draga pe formă controlul definit anterior. 


Pe forma aplicaţiei se pun controale ca în figura de mai jos. 
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S-au folosit: 
e un control de:.tip .Indicatori (instanța numită implicit 
` dndicatori1) în care se vor introduce observaţiile statistice şi se 
vor afişa indicatorii; | 
e un control de tip ListBox (variabila 1istBox1) pentru a afișa 
-abaterile medii liniare ale observaţiilor de la media lor. Abaterea 
medie anara a unei observații (x;) se calculează după formula: 
xj-m, i=I,n; 
unde: n — reprezintă numărul de observaţii iar m — media lor err! 


La apăsarea pe butonul Abaterile medii liniare se preiau 
observaţiile din controlul indicatori şi se afişează în controlul 1istBox1 
abaterile medii liniare: 


private void buttoni Click(object sender, System. EventArgs e) 
{ i 

double m = indicatoril.media; 

int n = indicatoril.numar_obs; 

listBoxl.Items.Clear(); //sterge continutul din ListBox 

for(int i=0;i<n;i++) i 

í i 

double t = indicatoril[i]-m; 
//adaugare articol in ListBox 
listBoxl.Items.Add(t.ToString("F")); 


Apăsarea pe butonul resire determină terminarea aplicaţiei. 


private void button2_Click (object sender, System.EventArgs e) 
{ Application.Exit(); | } 
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BindingContex să DialogBox 100 
boxing 53 Dlilmport 204 
Button drag and drop 
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catch a Bo 
 CheckBox ` să a z 3 
clasa abstracta 9, 12, evenimente | 87 
class 13 excepții ue 
Clipboard 200 Exit 
colecții l ve F 
ColorDialog Se S 
ata binding 223: finally 
ERES 267 Font 145 
componente 298 FontDialog i. 
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Console 16, 39 
107, foreach 
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I 
Comparer 
IDataObject 


IEnumerable 
IEnumerator 
IList 
ImageList 
indexare [] 
interface 


i K 
KeyDown 
KeyPress 
KeyUp 


L 
legare bidirectionala 
legare intarziata 
legare unidirectionala 
lista 
ListView 


M 

Main 

MainMenu 

masiv 

masiv bidimensional: 
masiv în scară 

MDI 

Modal Dialog Box 
Modless Dialog Box 
MouseDown 
MouseMove 
MouseUp 

Mouse Wheel 
multicasting 
multicasting 


309 


N 
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object 34 
Object 34 
ODBC 227, 
229 
OLEDB 227 
OleDbCommand 255 
OnPaint 50 
OpenFileDialog 145 
override 69 
P 
Panel 176 
Parameter Fields 171 
PrintDocument 155 
PrintPreviewDocument 161 
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proprietati 19 
proprietati statice . 20 
Queue: 18, 34 
= R 
RadioButon 65 
S 
SaveFileDialog 145 
Scroll Bar 67 . 
SDI 148 
serializare 125, 
152 
set 19 
simple data binding 219, 
_ 267 


SortedList 18 


Splitter 175 
Stack 18, 34 
StatusBar 120 
stiva 41 
string l 
struct 9,12, 
13 
T 
TextBox 60 
throw 91. 
tipul decimal 11 
tipuri de bază 9 
tipuri referentiale 9 
tipuri valorice 9 
ToolBar 114 
ToolTip 68 
TreeNode 129 
„ TreeView 128 
try 87 
typed DataSet 263 
; U | 
unboxing — 13 
untyped DataSet 263 
V 
validare 83 
value- 19 
vector 14 
vectori de obiecte 15, 
vectori de tipuri 15 
valorice 
virtual 32: 
vizualizare splitata 175 
W 
Windows Forms 49 
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